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Preface 



Here are your NFS Reference Manual Pages. You may place them behind 
you NFS User's Guide or put them in the binder labelled IRIS-4D Optional 
Manual Pages, You received this binder with your IRIS-4D Series 
Reference Manuals. 
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NAME 

domainname - set or display name of current YP domain 

SYNOPSIS 

domainname [ nameofdomain ] 

DESCRIPTION 

Without an argument, domainname displays the name of the current Yellow 
Pages domain. Only the super-user can set the domain name by giving an 
argument; this is usually done in the startup script letclinit.dlnetwork. 
Currently, the Yellow Pages uses domains only to refer collectively to a 
group of hosts. 

SEE ALSO 

ypinit(lM) 
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NAME 

on - execute a command remotely 

SYNOPSIS 

on [ -i ] [ — n ] [ -d ] host command [ argument ] . . . 

DESCRIPTION 

The on program is used to execute commands on another system, in an 
environment similar to that invoking the program. AH environment vari- 
ables are passed, and the current working directory is preserved. To 
preserve the working directory, the working file system must be either 
akeady mounted on the host or be exported to it. Relative path names will 
only work if they are within the current file system; absolute path names 
may cause problems. 

Standard input is connected to standard input of the remote command, and 
standard output and standard error from the remote command are sent to the 
corresponding files for the on command. 

OPTIONS 

-i Interactive mode: use remote echoing and special character process- 
ing. This option is needed for programs that expect to be talking to a 
terminal. All terminal modes and window size changes are pro- 
pagated. 

-n No Input: this option causes the remote program to get end-of-file 
when it reads from standard input, instead of passing standard input 
from die standard input of the on program. For example, -n is neces- 
sary when running commands in the background with job control. 

-d Debug mode: print out some messages as work is being done. 

SEE ALSO 

rexd( 1 M) , exports(4) 

DIAGNOSTICS 

unknown host 

Host name not found. 

cannot connect to server 

Host down or not running the rexd server. 

can't find • 

Problem finding the working directory. 

can't locate mount point 

Problem finding current file system. 
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Other error messages may be passed back from the server. 

BUGS 

The wmdow size is not set properly when executing interactively on Sun 
workstations. 
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NAME 

rup - show host status of local machines (RPC version) 

SYNOPSIS 

rup [-h] [-1] [-t] [host... ] 

DESCRIPTION 

Rup gives a status similar to uptime for remote machines; it broadcasts on | 
the local network, and displays the responses it receives. V 

Normally, the listing is in the order that responses are received, but this 
order can be changed by specifying one of the options listed below. 

When host arguments are given, rather than broadcasting rup will only 
query the list of specified hosts. 

A remote host will only respond if it is running the rstatd daemon, which is 
normally started up from inetd(lM). 

OPTIONS 

-h sort the display alphabetically by host name. 

-1 sort the display by load average. 

-t sort the display by up time. 

SEE ALSO 

ruptime(lC), inetd(lM), rstatd(lM) ^ 

BUGS \ 

Broadcasting does not work through gateways. 
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NAME 

rusers - who's logged in on local machines (RPC version) 

SYNOPSIS 

rusers [ -a ] [ -h ] [ -i ] [ -1 ] [ -u ] [ host ... ] 

DESCRIPTION 

The rusers command produces a listing of users on remote machines. It 
broadcasts on the local network, and prints the responses it receives. Nor- 
mally, the listing is in the order that responses are received, but this order 
can be changed by specifying one of the options listed below. When host 
arguments are given, rather than broadcasting rusers will only query the list 
of specified hosts. 

The default is to print out a listing with one line per machine. When the -1 
flag is given, a who{l) style listing is used. In addition, if a user hasn't 
typed to the system for a minute or more, the idle time is reported. 

A remote host will only respond if it is running the rusersd daemon, which 
is normally started up from inetd. 

OPTIONS 

-a gives a report for a machine even if no users are logged on. 

-h sort alphabetically by host name. 

-i sort by idle time. 

-1 Give a longer listing in the style of who . 

-u sort by number of users. 

SEE ALSO 

rwho(lC), inetd(lM), rusersd(lM) 

BUGS 

Broadcasting does not work through gateways. 



April 1990 -1- Version 3.0 



RWALL( 1 ) Silicon Graphics RWALL( 1 ) 

NAME 

rwall - write to all users over a network 

SYNOPSIS 

rwall hostl host2 ... 

rwall -n netgroupl netgroup2 ... 

rwall -h host -n netgroup 

DESCRIPTION 

Rwall reads a message from standard input until end-of-file. It then sends 
this message, preceded by the line * 'Broadcast Message ...", to all users 
logged in on the specified host machines. With the -n option, it sends to the 
specified network groups, which are defined in netgroup(4). 

A machine can only receive such a message if it is running nva/W(lm), 
which is normally started up by the daemon inetd(lm). 

SEE ALSO 

wall(l), rwalld(lM), netgroup(4) 

BUGS 

The timeout is fairly short in order to be able to send to a large group of 
machines (some of which may be down) in a reasonable amount of time. 
Thus the message may not get through to a heavily loaded machine. 
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NAME 

ypcat - print values in a YP data base 

SYNOPSIS 

ypcat [ -k ] [ -t ] [ -d domainname ] mname 
ypcat -X 

DESCRIPTION 

ypcat prints out values in a Yellow Pages (YP) map specified by mname, 
which may be either a mapname or a map nickname. Since ypcat uses the 
YP network services, no YP server is specified. 

To look at the network- wide password database, passwd.byname , (with the 
nickname passwd), type in: 

ypcat passwd 

Refer to ypfiles(4) and ypserv(lM) for an overview of the Yellow Pages. 

OPTIONS 

-k Display the keys for those maps in which the values are null or the 

key is not part of the value. (None of the maps derived from files 
that have an ASCII version in /etc fall into this class.) 

-t Inhibit translation of mname to mapname. For example, ypcat -t 

passwd will fail because there is no map named passwd, whereas 
ypcat passwd will be translated to ypcat passwd.byname . 

-d Specify a domain other that the default domain. The default 

domain is returned by domainname. 

-X Display the map nickname table. This lists the nicknames 

( mnames ) the command knows of, and indicates the mapname 
associated with each nickname. 

SEE ALSO 

ypfiles(4), ypserv(lM), ypmatch(l), domainname(l) 
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NAME 

ypchpass - change selected Yellow Pages passwd fields 

SYNOPSIS 

ypchpass [-f Jullname] [-h home] [-s shell] [name] 

DESCRIPTION 

Ypchpass changes selected passwd(4) fields associated with the user name 
(your own name by default) in the Yellow Pages. The Yellow Pages fields 
that can be modified with ypchpass may have different contents from those 
for the same user in the local I etcl passwd file. 

If invoked without options, ypchpass invokes the editor named by the 
environment variable EDITOR, or v/(l) if EDITOR is null or unset, to edit a 
template of selected passwd fields. After the user has edited this template 
and changed or added appropriate field contents, ypchpass checks the 
updated contents. If they are well-formed, it updates the Yellow Pages. 
Otherwise it prompts the user to re-edit the template. 

If invoked with options, ypchpass updates the Yellow Pages based on the 
options' arguments and does not interactively acquire new field contents 
using an editor. 

-ffullname . Change the user's real name field to contain fullname . 
A useful convention, observed by finger(l), divides this 
field into four comma-separated parts: the user's real 
name, office, extension, and home phone. 

-h home Change the initial working directory field to home . 

-s shell Change the shell field to shell. 

Only the owner of name may change its passwd fields. 

SEE ALSO 

yppasswd(l), ypfiles(4), rpc.passwd(lM) 
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NAME 

ypmatch - print the value of one or more keys from a YP map 

SYNOPSIS 

ypmatch [ -d domain ] [ -k] [-t] key .,. mname 
ypmatch -x 

DESCRIPTION 

ypmatch prints the values associated with one or more keys from the Yel- 
low Pages (YP) map (database) specified by a mname, which may be either 
a mapname or an map nickname . 

Multiple keys can be specified; the same map will be searched for all. The 
keys must be exact values insofar as capitalization and length are con- 
cerned. No pattern matching is available. If a key is not matched, a diag- 
nostic message is produced. 

OPTIONS 

-d Specify a domain other that the default domain. 

-k Before printing the value corresponding to a key, print the key 

itself, followed by a colon (*:'). This is useful only if the keys are 
not duplicated in the values, or you've specified so many keys that 
the output could be confusing. 

-t Inhibit translation of nickname to mapname. For example, 

ypmatch -t zippy passwd will fail because there is no map named 
passwd, while ypmatch zippy passwd will be translated to ypmatch 
zippy passwd.byname . 

-X Display the map nickname table. This lists the nicknames 

(mnames) the command knows of, and indicates the mapname 
associated with each nickname. 

SEE ALSO 

ypcat(l), ypfiles(4) 
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NAME 

yppasswd - change login password in Yellow Pages 

SYNOPSIS 

yppasswd [ name ] 

DESCRIPTION 

Yppasswd changes (or installs) a password associated with the user name 
(your own name by default) in the Yellow Pages. The Yellow Pages pass- 
word may be different from the one on your own machine. 

Yppasswd prompts for the old Yellow Pages password and then for the new 
one. The caller must supply both. The new password must be typed twice, 
to forestall mistakes. 

New passwords must be at least four characters long if they use a 
sufficiently rich alphabet and at least six characters long if monocase. 
These rules are relaxed if you are insistent enough. 

Only the owner of the name or the super-user may change a password; in 
either case you must prove you know the old password. 

SEE ALSO 

passwd(l), ypfiles(4), rpc.passwd(lM) 

BUGS 

The update protocol passes all the information to the server in one rpc call, 
without ever looking at it. Thus if you type in your old password 
incorrectly, you will not be notified until after you have entered your new 
password. 
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NAME 

ypwhich - print the YP server or map master hosttiame 

SYNOPSIS 

ypwhich [ -d domain ] [ -VI I -V2 ] [ hostname ] 
ypwhich [ -t ] [ -d domain ] -m mname 
ypwhich -x 

DESCRIPTION 

ypwhich tells which YP server supplies Yellow Pages services to a YP 
client, or which server is the master for a map. If invoked without argu- 
ments, it prints the YP server for the local machine. If hostname is 
specified, that machine is queried to find out which YP server it is using. 

Refer to ypfiles(4) and ypserv{lM) for an overview of the Yellow Pages. 



OPTIONS 

-d domain 

-VI 

-V2 



-m mname 



Use domain instead of the default domain. 

Which server is serving v.l YP protocol-speaking client 
processes? 

Which server is serving v.2 YP protocol client processes? 

If neither version is specified, ypwhich attempts to locate the 
server that supplies the (current) v.2 services. If there is no 
v.2 server currently bound, ypwhich then attempts to locate 
the server supplying the v.l services. Since YP servers and 
YP clients are both backward compatible, the user need sel- 
dom be concerned about which version is currently in use. 

Find the master YP server for a map. No hostname can be 
specified with -m. mname can be a mapname, or a nickname 
for a map. 

Inhibit nickname translation. This option is useful if there is 
a mapname identical to a nickname, which is not true of any 
SGI-supplied map. 

Display the map nickname table. This lists the nicknames 
(mnames) the command knows of, and indicates the map- 
name associated with each nickname. 



SEE ALSO 

rpcinfo(lM), ypserv(lM), ypset(lM), ypfiles(4) 
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NAME 

automount - automatically mount NFS filesystems 

SYNOPSIS 

/usr/etc/automount [ -mnTv ] [ -D name=^value ] [ -f master-file ] 
[ -M mount'directory ] [ -tl duration ] [ -tm interval ] 
[ -tw interval ] [ directory mapname [ -mount-options ] ] . . . 

DESCRIPTION 

automount is a daemon that automatically and transparently mounts an NFS 
filesystem as needed. It monitors attempts to access directories that are 
associated with an automount *'map." You can assign a map to a directory 
using an entry in a direct automount map, or by specifying an indirect map 
on the command line. 

The automount daemon is started during system initialization from the 
letclinit.dlnetwork script if the configuration flags **nfs" and *'automount" 
are set (see chkconfig(lM) and network(lM)). Site-dependent options and 
arguments to automount belong in the file I etclconfigl automount. options, 

automount appears to be an NFS server to the kernel, automount uses the 
map contained in the mapname argument to determine a server, exported 
filesystem, and appropriate mount options for a given filesystem. It then 
mounts the filesystem in a temporary location, and creates a symbolic link 
to the temporary location. If the filesystem is not accessed within an 
appropriate interval (five minutes by default), the daemon unmounts the 
filesystem and removes the symbolic link. 

By default, automount mounts everything under the directory Itmpjnnt. 
For instance, if a user wants to mount a remote directory src under lusrlsrc, 
the actual mount point will be Itmpjnntlusrisrc, and lusrlsrc will be a sym- 
bolic link to that location. As with any other kind of mount, a mount 
affected through the automounter on a non-empty mount point will hide the 
original contents of the mount point for as long as the mount is in effect. 

The name-to-location binding is dynamic, making updates to a Yellow 
Pages (YP) map transparent to the user. This obviates the need to **pre- 
mount" shared file systems for applications that have * 'hard-coded" refer- 
ences to files. Nor is there a need to maintain records of which hosts must 
be mounted for what applications. 

If the directory argument does not exist, automount creates it, and it is 
removed automatically when automount exits. 

If \ht directory argument is a pathname, the map argument must be an ■ 
indirect map. In an indirect map, the key for each entry is a simple name (as 
opposed to a full pathname) that represents a symbolic link within directory 
to an NFS mount point. 
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If the directory argument is 7-', the map that follows must be a direct map. 
A direct map is not associated with a single directory. Instead, the key for 
each entry is a full pathname that will itself appear to be a symbolic link to 
an NFS mount point. 

A map can be a file or a YP map; if a file, the map argument must be a full 
pathname. 

The -mount-options argument, when supplied, consists of the leading dash 
and a comma-separated list of mount {\M) options. If these options are sup- 
plied, they become the default mount options for all entries in the map. 
Mount options provided within a map entry override these defaults. 

OPTIONS 

-D var-value 

Assign value to the indicated automount (environment) variable. 

-f master-file 

Read a local file for initiaUzation, before reading the auto.master 
YP map. The information in master-file will take precedence. 

-m Suppress initialization of directory -mapname pairs listed in the 
automaster YP database. 

-M mount-directory 

Mount temporary filesy stems in the named directory, instead of 
Itmpjnnt, 

-n Disable dynamic mounts. With this option, references through the 

automount daemon only succeed when the target filesystem has 
been previously mounted. 

-T Trace. Expand each NFS call and display it on the standard output. 

-tl duration 

Specify a duration, in seconds, that a looked up name remains 
cached when not in use. The default is 5 minutes. 

-tm interval 

Specify an interval, in seconds, between attempts to mount a 
filesystem. The default is 30 seconds. 

-tw interval 

Specify an interval, in seconds, between attempts to dismount 
filesystems that have exceeded their cached times. The default is 1 
minute. 

-v Verbose. Log status and/or warning messages to the console. 
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ENVIRONMENT 

Environment variables can be used within an automount map. For instance, 
if $HOME appeared within a map, automount would expand it to its current 
value for the HOME variable. Environment variables are expanded only 
for the automounter's environment — not for the environment of a user 
using the automounter's services. 

USAGE 

Map Entry Format 

A simple map entry (mapping) takes the form: 

key [ -mount-options ] location „. 

where key is the full pathname of the directory to mount when used in a 
direct map, or simple name in an indirect map. mount-options is a comma- 
separated list of mount options, and location specifies a remote filesystem 
from which the directory may be mounted. In the simple case, location 
takes the form: 

hostname:pathname 

Replicated Filesystems 

Multiple location fields can be specified for repUcated read-only filesys- 
tems, in which case automount sends multiple mount requests; automount 
mounts the filesystem from the first host that replies to the mount request. 
This request is first made to the local net or subnet. If there is no response, 
any connected server may respond. Since automount does not monitor the 
status of the server while the filesystem is mounted, it will not use another 
location in the list if the currently mounted server crashes. This support for 
replicated filesystems is available only at mount time. Once unmounted, 
another loqation may be used for subsequent mounts of the filesystem. 

If each location in the list shares the same pathname then a single location 
may be used with a comma-separated Ust of hostnames. 

hostnamel,hostname2:pathname 

Sharing Mounts 

If /<9car/(9n is specified in the form: 

hostname:pathname:subdir 

hostname is the name of the server from which to mount the filesystem, 
pathname is the pathname of the directory to mount, and subdir, when sup- 
plied, is the name of a subdirectory to which the symbolic link is made. 
This can be used to prevent duplicate mounts when multiple directories in i 
the same remote filesystem may be accessed. With a map for /home such ^ 
as: 
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bart homes:/home/simpsons:bart 
homer homes:/home/simpsons:homer 

and a user attempting to access a file in /home/bart, automount mounts 
homes : I homel Simpsons, but creates a symbolic link called /home/bart to the 
bart subdirectory in the temporarily-mounted filesystem. If a user immedi- 
ately tries to access a file in /home/ homer, automount needs only to create a 
symbolic link that points to the homer subdirectory; /home/simpsons is 
already mounted. 

With the following map: 

bart homes:/home/siinpsonsA)art 
homer homes:/home/simpsons/homer 

automount would have to mount the filesystem twice. 

Comments and Quoting 

A mapping can be continued across input lines by escaping the NEWLINE 
with a backslash. Comments begin with a # and end at the subsequent 
NEWLINE. 

Characters that have special significance to the automount map parser may 
be protected either with double quotes (") or by escaping with a backslash 
(\). Pathnames with embedded whitespace, colons (:) or dollar ($) should be 
protected. 

Directory Pattern Matching 

The *&' character is expanded to the value of the key field for the entry in 
which it occurs. In this case: 

bart homes:/home/simpsons: & 

the & expands to bart. The **' character, when supplied as the key field, is 
recognized as the catch-all entry. Such an entry will be used if any previous 
entry has not successfully matched the key being searched for. For instance, 
if the following entry appeared in the indirect map for /home: 

* &:/home/& 

this would allow automatic mounts in /home of any remote filesystem 
whose location could be specified as: 

hostname:/home/hostname 

Multiple Mounts 

A multiple mount entry takes the form: 

key [ /[mountpoint [ -mount-options ] location ... ] ... 
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The initial / within the /[mountpoint] is required; the optional mountpoint is 
taken as a pathname relative to the destination of the symbolic link for key. 
If mountpoint is omitted in the first occurrence, a mount point of / is 
impUed. 

Given the direct map entry: 

/tools \ 

/ -ro dill:/tools inmt:/tools \ 

/l.O -ro mint:/tools/1.0 dilh/tools/l.O \ 

/1.0/man -ro dill:/tools/1.0/man mmt:/tools/1.0/maii 

automount would automatically mount Itools, ItoolslLO and /tools/1. 0/man, 
as needed, from either dill or mint, whichever host responded first. If the 
mounts are hierarchically related, mounts closer to the root must appear 
before submounts. All the mounts of a multiple mount entry will occur 
together and will be unmounted together. This is important if the filesys- 
tems reference each other with relative symbolic links. Multiple mount 
entries can be used both in direct maps and in indirect maps. 

Included Maps 

The contents of another map can be included within a map with an entry of 
the form: 

+mapname 

mapname can either be a filename, or the name of a YP map, or one of the 
special maps described below. If the key being searched for is not located in 
an included map, the search continues with the next entry. 

Special Maps 

There are two special maps currently available: -hosts, and -null. The 
-hosts map uses the YP hosts.byname map to locate a remote host when the 
hostname is specified. This map specifies mounts of all exported filesystems 
from any host. For instance, if the following automount command is already 
in effect: 

automount /net -hosts 

then a reference to /net/lambada/usr would initiate an automatic mount of 
all filesystems from lambada that automount can mount; references to a 
directory under /net/lambada will refer to the corresponding directory rela- 
tive to lambada 's root. 

The -null map, when indicated on the command line, cancels any subse- 
quent map for the directory indicated. It can be used to cancel a map given 
in auto. master or for a mount point specified as an entry in a direct map. 
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Configuration and the auto.master Map 

automount normally consults the auto.master YP configuration map for a 
list of initial automount maps, and sets up automatic mounts for them in 
addition to those given on the command line. If there are duplications, the 
command-line arguments take precedence over a local -f master map and 
they both take precedence over a YP auto.master map. This configuration 
database contains arguments to the automount command, rather than map- 
pings; unless -f is in effect, automount does not look for an auto.master file 
on the local host. 

Maps given on the command line, or those given in a local auto.master file 
specified with -f override those in the YP auto.master map. For instance, 
given the command: 

automount -f /etc/auto.master /home -null /- /etc/auto.direct 

and a file named I etc I auto. master that contains: 
/home auto.home 

automount would ignore the Ihome entry in I etc/ auto. master. 



FILES 



/tmp_mnt 

directory under which filesystems are dynamically mounted 



SEE ALSO 

mount(lM), network(lM) 



NOTE 



The -hosts map must mount all the exported filesystems from a server. If 
frequent access to just a single filesystem is required it is more efficient to 
access the filesystem with a map entry that is tailored to mount just the 
filesystem of interest. 

When it receives signal number 1, SIGHUP, automount rereads the 
letclmtab file to update its internal record of currently-mounted filesystems. 
If a filesystem mounted with automount is unmounted with the umount{\M) 
command, automount should be forced to reread the file. 

An ls{\) listing of the entries in the directory for an indirect map shows 
only the symbolic links for currently mounted filesystems. This restriction is 
intended to avoid unnecessary mounts as a side effect of programs that read 
the directory and stati^) each of the names. 

Mount points for a single automounter must not be hierarchically related. 
automount will not allow an automount mount point to be created within an 
automounted filesystem. 
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automount must not be terminated with the SIGKILL signal. Without an 
opportunity to unmount itself, the automount mount points will appear to 
the kernel to belong to a non-responding NFS server. The recommended 
way to terminate automount services is to send a SIGTERM signal to the 
daemon: 

/etc/killall -TERM automount 

This allows the automounter to catch the signal and unmount not only its 
daemon but also any mounts in Itmpjnnt. Mounts in Itmpjnnt that are 
busy will not be unmounted. 

Since each direct map entry results in a separate mount for the mount dae- 
mon such maps should be kept short. Entries added to a direct map will 
have no effect until the automounter is restarted. 

Entries in both direct and indirect maps can be modified at any time. The 
new information will be used when automount next uses the map entry to 
do a mount, automount does not cache map entries. 



BUGS 



The bg mount option is not recognized by the automounter. 

Since automount is single-threaded, any request that is delayed by a slow or 
non-responding NFS server will delay all subsequent automatic mount 
requests until it completes. 

Programs that read letclmtab and then touch files that reside under 
automatic mount points will introduce further entries to the file. 
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NAME 

bootparamd - boot parameter server 

SYNOPSIS 

/usr/etc/rpc.bootparamd [-d] [-i] 

DESCRIPTION 

bootparamd is a server process that provides information to diskless clients 
necessary for booting. It consults the bootparams database. If the client is 
not found there, or if the Yellow Pages service is not running, then the 
/etc/bootparams file is consulted. 

bootparamd can be invoked either by inetd(lM) or by the user. 

OPTIONS 

-d Display the debugging information. 

-i Ignore inter-domain *'whoami" requests. If instances of 

ypserv (IM) on directly connected networks are invoked with the -i 
option, and if hosts in the local Yellow Pages domain have primary 
hostnames formed by concatenating a name containing no periods, 
a period, and the YP domain name, use -i with bootparamd. 



NOTES 



In the absence of -i, instances of bootparamd in different domains may 
receive a **whoami" broadcast, consult YP to find the requester's hostname 
by its address, receive the answer from a different domain (owing to ypserv 
-i), and reply with the wrong domain name. 



FILES 



/etc/bootparams 

SEE ALSO 

bootparams(4), metd(lM), ypserv(lM) 
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NAME 

cl_init - init program for diskless software installation 

SYNOPSIS 

/etc/cMnit 

DESCRIPTION 

cljnit is the init(lM) program in diskless share tree. When client worksta- 
tion installs its software using PROM menu, the workstation will use the 
share tree as the root and process 1 will be running cljnit instead of the 
regular letclinit, 

cljnit will prompt user for the following questions: 

Do you want to use server XXX for software installation (y/n) ? 

where XXX is the default server name used in the tapedevice or bootfile 
PROM variables. When doing installation, this default is the name of the 
server that contains the share tree. If the client tree will be installed on a 
different server, user should answer n here. 

Enter server name : 

Enter the correct server name for client tree, cljnit will check the server 
name with the /etc/hosts file in the share tree. If the server name is not in 
this host file, cljnit will re-prompt the user for appropriate action. 

Do you want to install client YYY on server XXX (y/n) ? 

where XXX is the server name, and YYY is the hostname that is set in PROM 
variable hostname, or translated from netaddr using bootparamd(iM) ser- 
vice. 

Enter password for autoinst : 

If the autoinst login entry at server machine requires password, user should 
key in the password at this prompt. Once the password is accepted, the 
inst(lM) menu will appear on the screen. 

Ready to exit (y/n) ? 

cljnit will repeat the installation procedure again if the answer is n. Other- 
wise, it will set PROM variables, netaddr and bootfile , and reboot itself. 

cljnit always login the server using default login name autoinst. User can 
set environment variable dllogin in the PROM to change the login name. 
For example, typing 

setenv dllogin root 

at prom manual mode will cause the diskless workstation login the server 
using root. 



April 1990 -1- Version 3.0 



C 



( 



( 



CL_IN1T( IM ) Silicon Graphics CL_INIT( IM ) 

When using default login - autoinst, all messages before the inst(lM) menu 
are filtered. If there is a need for examining the login messages, such as for 
debugging purposes, it is possible to disable the feature by typing two or 
more escape characters before entering the password. 

CAVEAT 

cljnit is to be used only by diskless client installation package. If cljnit is 
invoked on a shell command line, the shell will hang. If the hung shell 
receives an INTR signal, the system will be shutdown silently. 

SEE ALSO 

init(lM), bootparamd(lM), inst(lM) 
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NAME 



clinst - diskless client software installation tool 



SYNOPSIS 

clinst -c class [ -d ] share 

clinst -c class -h host [ -d ] client 

clinst -r 

DESCRIPTION 

Clinst is the tool for diskless workstation users to install the system 
software. When multiple users are using the same version of software, only 
one copy is needed. This single software tree is called a share tree which 
will be shared among the users. Each user has to create an private tree that 
contains mosdy symbolic links to the share tree except for those files that 
can not be shared. This private tree is called a client tree. A share tree 
represents a class. Each use should select the class when installing the 
client tree, clinst serves the purposes of both installing and removing the 
share or client tree. 

For each class, clinst needs a parameter file in the directory /usr/etc/boot to 
supply the necessary configuration information. Class.dat (where class 
should be replaced by the actual name of the class) should be created in 
/usr/etc/boot by copying the template clinst.dat from the same directory and 
modify the parameters according to the desired local configuration. Since 
clinst.dat is a shell script that will be invoked from within the clinst, it 
should always be executable. A good practice to modify the file is to 
change the strings within the double quotes only, clinst.dat contains the fol- 
lowing variables: 



( 



c 



DISKLESS optional directory prefix for share root, client root, swap 

file and dump file 



CLROOT 



directory name for client root 



SHAREHOST hostname for the share root. If share tree locates on dif- 
ferent server then client tree, clinst should be run on 
shared server with target share, and on client tree server 
with target client. 



SHARE directory name for share root 

SWAP name of directory where swap file will be created. The 

swap du-ectory must be on the same server as client root. 



( 
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SWAPSIZE size of swap file. The default is set to 20 MB. 

DUMP name of directory where dump file will be created. The 

dump directory must be on the same server as client root. 

GFXBOARD type of graphics board 

CPUBO ARD type of cpu board 

M ACH type of machine 

BOOTP_DIR the home directory of bootp(lM) 

YP indicates whether yp is used 

clinst is a shell script that will call inst(lM) to perform the software instal- 
lation. It also modified the resulting tree so that diskless workstation can be 
brought up correctly, clinst creates the swap file, dump file, and client boot 
parameters for each installation, it also exports the directories created to the 
appropriate host. 

There are two modes for clinst to operate, the manual mode and automatic 
mode. In manual mode, clinst is used as a regular UNIX command with 
command line parameters described in the following sections. In automatic 
mode, clinst is invoked from remote login with user name autoinst. Diskless 
client will automatically enter this mode when software installation option 
is selected at prom level. Server should have an entry for autoinst in its 
password file with user id and group id set to and lusrletclbootlrclinst , 
which invokes clinst with -r flag, designated as shell. System administrator 
should determine whether the password is necessary. 

OPTIONS 

-c class Using class class. The file class.dat should exist in 

/usr/etc/boot directory. 

-h host Indicates the client tree is created for workstation named 

host. The host must be a valid hostname, i.e. it should 
have already been assigned an IP address. This parameter 
does not have any effect when creating share tree. 

-d To remove the diskless tree. The default is to install the 

tree. 
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share | client To create a share tree if share is specified, and to create a 
client tree when client is specified. When creating chent 
tree, the host must be supplied. 

EXAMPLE 

/usr/etc/boot/clinst -c 4D20 share 

will create a share tree for class 4D20, The lusrletclbootl4D20.dat file 
should exist before you run the command. 



( 



FILES 



/usr/etc/boot/clinst 

/usr/etc/boot/clinst.dat Template for class.dat 



SEE ALSO 

inst(lM), rclinst(lM) 
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NAME 

exportfs - export and unexport directories to NFS clients 

SYNOPSIS 

/usr/etc/exportfs [ -aiuv ] [ -o options ] [ directory ] 

DESCRIPTION 

Exportfs makes a local directory (or file) available for mounting over the 
network by NFS clients. It is normally invoked at boot time by the 
letclinit.dlnetwork script, and uses information contained in the /etc/exports 
file to export a directory (which must be specified as a full pathname). The 
super-user can run exportfs at any time to alter the list or characteristics of 
exported directories. Directories that are currently exported are listed in 
thc&\c/etc/xtab. 

Widi no options or arguments, exportfs prints out the list of directories 
currently exported. 

OPTIONS 

-a All. Export all directories listed in /etc/exports, or if -u is 

specified, unexport all of the currently exported directories. 

-V Verbose. Print each directory as it is exported or unexported. 

-u Unexport the indicated directories. 

-i Ignore the options in /etc/exports. Normally, exportfs will consult 

/etc/exports for the options associated with the exported directory. 

-o options 

Specify a comma-separated list of optional characteristics for the 
directory being exported. Options are described in exports(4). 

FILES 

/etc/exports static export information 

/etc/xtab current state of exported directories 

/etc/netgroup 

SEE ALSO 

exports(4), netgroup(4) 

WARNINGS 

You cannot export a directory that is either a parent- or a sub-directory of 
one that is currently exported and within the same filesystem. It would be 
illegal, for example, to export both /usr and lusrllocal if both directories 
resided in the same disk partition. 
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NAME 

lockd - network lock daemon 

SYNOPSIS 

/usr/etc/rpcJockd [ -t timeout ] [ -g graceperiod ] 

DESCRIPTION 

lockd provides the inherently stateful locking services within the stateless 
NFS environment. It allows the locking of records and files between appli- 
cations running on different physical machines. 

Locks are presently advisory only. The lock style implemented by lockd is 
that specified in the SVID (see locJ^QC) and fcntl (2)). There is no interac- 
tion between the lockd's locks andjf?^c^(3B) style locks. 

lockd is started from inetd(lM). It processes lock requests that are either 
sent locally by the kernel or remotely by another lock daemon. In the case 
of local lock requests for remote data, lockd forwards the lock requests to 
the server site's lock daemon through the RPC/XDR(3R) package, lockd 
then requests the local status monitor daemon, statd(lM), for monitor ser- 
vice of the server. The reply to the lock request will not be sent to the kernel 
until the status daemon and the server site's lock daemon have replied. 

When a server recovers, it waits for a grace period for all client site lockds 
to submit reclaim requests. Client site lockds are notified by the statd of 
the server recovery and promptly resubmit previously granted lock requests. 
If a lockd fails to secure a previously granted lock at the server site, it sends 
SIGUSRl to the appUcation process. 

OPTIONS 

-t timeout lockd uses timeout (seconds) as the interval instead of the 
default value (15 seconds) to retransmit lock request to the 
remote server. 

-g graceperiod 

lockd uses graceperiod (seconds) as the grace period duration 
instead of the default value (45 seconds). 

NOTE 

The reply to a lock request for remote data is delayed until all daemons 
become available. 

In the Sun implementation, lockd sends SIGLOST. The IRIX implementa- 
tion sends SIGUSRl. 

SEE ALSO 

fcntl(2), inetd(lM), lockf(3C), signal(2), statd(lM) 
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NAME 

makedbm - make a Yellow Pages dbm file 

SYNOPSIS 

/usr/etc/yp/makedbm [ -i ypjnputjile ] [ -o yp_output_name ] 
[ -d yp_domain_name ] [ -m ypjnasterjiame ] 
injile outfile 
/usr/etc/yp/makedbm [ -u dbmfilename ] 

DESCRIPnON 

Makedbm takes infile and converts it to a pair of files in dbm(3B) format, 
namely outfile. pag and outfile.^. Each line of the input file is converted to 
a single dbm record. All characters up to the first tab or space form the key, 
and the rest of the line is the data. If a line ends with \ then the data for that 
record is continued on to the next line. It is left for the clients of the Yellow 
Pages to interpret #; makedbm does not itself treat it as a comment charac- 
ter, infile can be -, in which case standard input is read. 

Makedbm is meant to be used in generating dbm files for the Yellow Pages, 
and it generates a special entry with the key ypjastjnodified, which is the 
date of infile (or the current time, if infile is -). 

opnoNS 

-i Create a special entry with the key ypjnputjile . 

-o Create a special entry with the key yp_output_name . 

-d Create a special entry with the key yp_domain_name . 

-m Create a special entry with the key ypjnasterjiame. If no master 
host name is specified, ypjnasterjiame will be set to the local 
host name. 

-u Undo a dbm file. That is, print out a dbm file one entry per line, 
with a single space separating keys from values. 

EXAMPLE 

It is easy to write shell scripts to convert standard files such as /etc/passwd 
to the key value form used by makedbm . For example, 

# ! /usr/bin/awk -f 

BEGIN { FS = ":"; OFS = "\t"; } 

{ print $1, $0 } 

takes the /etc/passwd file and converts it to a form that can be read by mak- 
edbm to make the Yellow Pages file passwd.byname. That is, the key is a 
usemame, and the value is the remaining line in the /etc/passwd file. 
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SEE ALSO 

yppasswd(lM), dbm(3B) 
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NAME 

mountd - NFS mount request server 

SYNOPSIS 

/usr/etc/rpc.mountd [ -n ] 

DESCRIPTION 

Mountd is an rpc(4) server that answers file system mount requests. It 
reads the file /etc/exports, described in exports(4), to determine which file 
systems are available to which machines and users. It also provides infor- 
mation as to which clients have file systems mounted. This information can 
be printed using the showmount(lM) command. 

Normally, mountd only accepts requests fi-om clients using a privileged 
(i.e., secure) port. The -n option disables this check and allows mountd to 
accept requests from any port. 

The mountd daemon is normally invoked by inetd(lm). 

SEE ALSO 

inetd(lM), showmount(lM), exports(4), services(4) 
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NAME 

nfsd, biod - NFS daemons 

SYNOPSIS 

/usr/etc/nfsd [ nservers ] 
/usr/etc/biod [ nservers ] 

DESCRIPTION 

nfsd starts the nfs{A) server daemons that handle cUent filesystem requests. 
Nservers is the number of file system request daemons to start. This 
number should be based on the load expected on this server. Four seems to 
be a good number. 

Biod starts nservers asynchronous block I/O daemons. This command is 
used on a NFS client to buffer cache handle read-ahead and write-behind. 
The magic number for nservers in here is also four. 

These daemons are started during system initialization from the 
/etc/init.d/network script if the configuration flag **nfs'* is set on (see 
network{\M)), 

When a file that is opened by a client is unUnked (by the server), a file with 
a name of the form .nfsXXX (where XXX is a number) is created by the 
cUent. When the open file is closed, the .nfsXXX file is removed. If the 
client crashes before the file can be closed, the .nfsXXX file is not removed. 

( 

.nfsXXX client machine pointer to an open-but-unlinked file ^ 



FILES 



SEE ALSO 

exportfs(lM), mountd(lM), network(lM), exports(4) 
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NAME 

nfsstat - display Network File System statistics 

SYNOPSIS 

/usr/etc/nfsstat [ -csnrdz ] [ unix ] [ core ] 

DESCRIPTION 

Nfsstat displays statistical information about the Network File System 
(NFS) and Remote Procedure Call (RPC) interfaces to the kernel. It can 
also be used to reinitialize this information. If no options are given the 
default is 

nfsstat -csnr 

That is, print everything and reinitialize nothing. The optional arguments 
unix and core may be used to indicate another system namelist and kernel 
memory image, respectively. 

OPTIONS 

-c Display client information. Only the client side NFS and RPC 

information will be printed. Can be combined with the -n and -r 
options to print client NFS or client RPC information only. 

-s Display server information. Works like the -c option above. 

-n Display NFS information. NFS information for both the client and 

server side will be printed. Can be combined with the -c and -s 
options to print client or server NFS information only. 

-r Display RPC information. Works like the -n option above. 

-z Zero (reinitialize) statistics. Can be combined with any of the 

above options to zero particular sets of statistics after printing 
them. The user must have super-user privilege for this option to 
work. 

FILES 

/unix system namelist 

/dev/kmem kernel memory 
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NAME 

rarpd - DARPA Reverse Address Resolution Protocol daemon 

SYNOPSIS 

/usr/etc/rarpd [-d] [-1 logfile] [interface...] 

DESCRIPTION 

Rarpd responds to Reverse Address Resolution Protocol (Reverse ARP, 
RARP) requests. It puts itself in the background, and requires root 
privileges. 

The Reverse ARP protocol is used by machines at boot time to discover 
their 32-bit Internet Protocol (IP) address given their 48-bit Ethernet 
address. In order for a RARP request to be answered, the requesting 
machine's name-to-IP-address entry must exist in the /etc/hosts file and its 
name-to-Ethemet-address entry must exist in the /etc/ethers file. Note that 
if the server machine running rarpd is using the Yellow Pages, the server's 
/etc files are ignored and the appropriate Yellow Pages maps are queried. 

Normally rarpd serves all configured IP interfaces which support broadcast- 
ing. Optional interface arguments restrict service to only those interfaces. 
The -d option causes rarpd to run in the foreground and log diagnostics on 
its standard error output. The -1 option causes rarpd to record requests in 
logfile. 

FILES 

/usr/adm/S YSLOG system log 

/etc/init.d/network networking start-up script 

/etc/config/rarpd configuration switch 

/etc/config/rarpd.options configuration options 

SEE ALSO 

chkconfig(lM), ifconfig(lM), ethers(4), hosts(4). 

Finlayson, Ross, Timothy Mann, Jeffrey Mogul, and Marvin Theimer, A 
Reverse Address Resolution Protocol, RFC 903, Network Information 
Center, SRI International, Menlo Park, CA, June 1984. 
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NAME 

rclinst - diskless client software auto-installation tool 

SYNOPSIS 

/usr/etc/boot/rclinst 

DESCRIPTION 

rclinst is the script that should be used for the autoinst entry in the 
/etc/passwd file. The autoinst entry in the password file is needed in order 
to enable diskless workstation to install the software from the local 
machine. The format of the entry should look like: 

autoinst: : 0: 0: /us r /etc/boot : /usr/etc/boot/rclinst 

will invoke clinst(lM) using the -r option. 

SEE ALSO 

clinst(lM), clJnit(lM) 
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NAME 

registrar - DP address update command for yp hosts data base 

SYNOPSIS 

/usr/etc/yp/registrar host-file "make hosts" 

DESCRIPTION 

registrar, which runs on yp master only, is a YP hostname data base update 
program. A hostname registration request can be sent from either 
yp_host(lM) command, or from the PROM IP address auto-registration 
function. This requests is initially sent to a rpc daemon process 
rpc.ypupdated(lM). registrar is invoked indirectly by rpc.ypupdated(lM) 
via an intermediate make file updaters(4). 

The host-file parameter should be the host file that is used in YP data base 
makefile, lusr I etcly pi Makefile. Usually, it is /etc/hosts. 

registrar knows how to receive the input parameters from 
rpc.ypupdated(lM), The input parameters tell registrar whether to allocate 
a new IP address, to change the existing hostname entry, or to delete the 
entry, along with the necessary information to service the request. 

When adding new hostname entry, there is no authentication checking. As 
long as the new hostname and the aliases are not yet used, the registration 
request will always be executed. When changing or deleting hostname 
entry, the yp master root password has to be passed along with the com- 
mand. 

The new IP address will be selected with the first available address that is in 
the same network/subnet specified in the request. System administrator can, 
however, mark a specific range in the /etc/hosts for address allocation by a 
special comment line. The format of this line should be 

# registrar start=xxx end=yyy mask=Oxzzzzzzzz 

where xxx is the IP address with the smallest local network address in the 
range, yyy is the IP address with largest local network address in the range, 
and zzzzzzzz is the 8-byte hexadecimal mask value. The xxx and yyy must 
fall into the same network, or subnet if netmask is specified. 

There can be several lines of comment for the address allocation for the 
same network or subnet. The registrar will use the first available address 
by searching through the comment lines sequentially. In case all address 
ranges described by the comment lines are used, registrar will choose the 
lowest available IP address that is in the same network or subnet. 
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FILES 

/etc/hosts 
/usr/etc/yp/updaters 

EXAMPLE 

Use 

#registrar start=192.26.1.10 end=192.26.1.20 mask=Oxffffm)0 

to reserve 192.26.L10 through 192.26.L20 for network 192.26.L 

SEE ALSO 

yp_host(lM), updaters(4), ypupdated(lM) 
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NAME 

rexd - RPC-based remote execution server 

SYNOPSIS 

/usr/etc/rpcrexd 

DESCRIPTION 

rexd is the rpc{A) server for remote program execution. This daemon is 
started by inetd{lM) whenever a remote execution request is made (see the 
note below). For non-interactive programs standard file descriptors are 
connected directly to TCP connections. Interactive programs involve 
pseudo-terminals, similar to the login sessions provided by rlogin(lC). 
This daemon may use the NFS to mount file systems specified in the remote 
execution request. 

rexd should be used on trusted networks only. It is not automatically 
enabled in the /usr/etc/inetd.conf Qlc. To enable rexd, edit inetd.conf and 
remove the comment character preceding the rexd entry and signal inetd to 
read the file: 

/etc/killall -HUP inetd 

DIAGNOSTICS 

Diagnostic messages are logged to syslogd{lM), and retumed to the reques- 
ter. 

RESTRICTIONS 

The super-user cannot execute commands using rexd client programs such 
ason(lC). 

FILES 

/dev/ttyqw pseudo-terminals used for interactive mode. 

/etc/passwd authorized users. 

/usr/tmp_rex/rexd????? temporary mount points for remote file systems. 

SEE ALSO 

on(lC), exports(4), rpc(4), inetd(lM) 



BUGS 



Access control is not secure. 

Does not properly handle window size information sent by Sun worksta- 
tions. 
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NAME 

rpc.passwd - server for modifying Yellow Pages password file 

SYNOPSIS 

/usr/etc/rpcpasswd ^/^ [ -m argl argl ... ] 

DESCRIPTION 

rpc.passwd is a server that handles password change requests from 
yppasswd{l). It changes a password entry 'mfile, which is assumed to be in 
the format oi passwd(A). An entry in file will only be changed if the pass- 
word presented by yppasswd{\) matches the encrypted password of that 
entry. 

If the -m option is given, then after yife is modified, a make (I) will be per- 
formed in /usr/etc/yp. Any arguments following the flag will be passed to 
make. 

This server should be run on the host serving as the Yellow Pages master. 
It is started from the /etc/init.dl network startup script if the "yp" and 
**ypn^aster" configuration flags are set on (see network(lM)). The startup 
script invokes the server using /etclpasswd as the Yellow Pages password 
file and causes password changes to be propagated immediately. To use a 
different YP passwd file, put the file's name in 
letclconfiglrpc.passwd,options and change the PWFILE variable in 
/usr/etc/yp/Makefile . 

FILES 

/usr/etc/yp/Makefile 

SEE ALSO 

network(lM), ypmake(lM), yppasswd(l), passwd(4), ypfiles(4) 

CAVEAT 

This server will eventually be replaced with a more general service for 
modifying any map in the Yellow Pages 
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NAME 

rstatd - kernel statistics server 

SYNOPSIS 

/usr/etc/rpcrstatd 

DESCRIPTION 

Rstatd is an rpc{A) server which returns performance statistics obtained 
from the kernel. The rstatd daemon is normally invoked by inetd{\M). 

SEE ALSO 

inetd(lM) 
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NAME 

rusersd - network usemame server 

SYNOPSIS 

/usr/etc/rpcrusersd 

DESCRIFnON 

Rusersd is an rpc{A) server that returns a list of users on the network. The 
rusersd daemon is normally invoked by inetd{lM). 

SEE ALSO 

rusers(lC), services(4), inetd(lM) 
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NAME 

rwalld - network rwall server 

SYNOPSIS 

/usr/etc/rpcrwalld 

DESCRIPTION ^ 

Rwalld is a server that handles rwall(l) and shutdown(l) requests. It is ■ 

implemented by calling wallil) to all the appropriate network machines. ^ 
The rwalld daemon is normally invoked by inetd{\M). 

SEE ALSO 

rwall(l), wall(l), inetd(lM) 
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NAME 

showmount - show all remote mounts 

SYNOPSIS 

/etc/showmount [-a] [-d] [-e] [-x] [host] 

DESCRIPTION 

Showmount lists all the clients that have remotely mounted a filesystem 
from host. This information is maintained by the mountd(lM) server on 
host, and is saved across crashes in the file letclrmtab. The default value 
for host is the value returned by hostname (I). 

OPTIONS 

-a Print all remote mounts in the format hostname .'directory where 

hostname is the name of the cHent, and directory is the root of the 
file system that has been mounted. 

-d List directories that have been remotely mounted by chents. 

-e Print the list of exported file systems. For each file system, list the 

cHents given mount access. 

-X Print the list of exported file systems and all of their export 

options, in the format described by exports(4). This option option 
overrides the -e option. 

SEE ALSO 

mountd(lM), exportfs(lM), exports(4) 

BUGS 

If a cUent crashes, its entry will not be removed from letclrmtab until it 
reboots and executes umount -a. 
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NAME 

spray - spray packets 

SYNOPSIS 

/usr/etc/spray host [ -c count ] [ -d delay ] [ -i delay ] [ -1 length ] 

DESCRIPTION 

spray sends a one-way stream of packets to host using RPC, and then 
reports how many were received by host and what the transfer rate was. 
The host name can be either a name or an Internet address. 

OPTIONS 

-c count Specifies how many packets to send. The default value of 
count is the numbers of packets required to make the total 
stream size 100000 bytes. 

-d delay Specifies how may microseconds to pause between sending 
each packet. The default is 0. 

-i Use ICMP echo packets radier than RPC. Since ICMP 

automatically echos, this creates a two way stream. 

-1 length The length parameter is the numbers of bytes in the ethemet 
packet that holds the RFC call message. Since the data is 
encoded using XDR, and XDR only deals with 32 bit quanti- 
ties, not all values of length are possible, and spray rounds up 
tp^ the nearest possible value. When length is greater than 
1514, then the RPC call can no longer be encapsulated in one 
Ethemet packet, so the length field no longer has a simple 
correspondence to Ethemet packet size. The default value of 
length is 86 bytes (the size of the RPC and UDP headers) 

SEE ALSO 

icmp(7P), ping(lM), sprayd(lM) 
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NAME 

sprayd - spray server 

SYNOPSIS 

/usr/etc/rpcsprayd 

DESCRIPTION 

rpc.sprayd is a server which records the packets sent by spray {IM), The 
rpc.sprayd daemon is normally invoked by inetd{\M). 

SEE ALSO 

inetd(lM), spray(lM). 
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NAME 

statd - network status monitor daemon 

SYNOPSIS 

/usr/etc/rpcstatd 

DESCRIPTION 

statd is an intermediate version of the status monitor. It implements a sim- I 
pie protocol which allows applications to monitor the status of other ^ 
machines. loclcd(lM) uses statd to detect both cHent and server failures. 

statd is started during system initialization if the chkconjig (IM) "lockd" 
flag is set on. 

Applications use RFC to register machines they want monitored by statd. 
The status monitor maintains a database of machines to track and the 
corresponding applications to notify of crashes. It also maintains a database 
of machines to notify upon recovery of its own host machine and a counter 
of the number of times it has "recovered". 

FILES 

/usr/etc/statd.d/sm machines to monitor 

/usr/etc/statd.d/sm.bak machines to notify upon recovery 

/usr/etc/statd.d/state recovery counter (a.k.a. version number) 

SEE ALSO 

network(lM), lockd(lM), statmon(4) | 

BUGS 

The crash of a site is only detected upon its recovery. 



( 
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NAME 

updbootparam - YP bootparams database update program 

SYNOPSIS 

/usr/etc/yp/updbootparam bootparams-file "make bootparams" 

DESCRIPTION 

Updbootparam, which runs on yp master only, is the YP bootparams (A) 
update program that will modify the data base upon request. An update 
request is sent from ypjbootparam (IM) command using rpc call. Updboot- 
param is invoked indirectly by rpc daemon rpc.ypupdated(lM) via an inter- 
mediate makefile updaters{A), 

Updbootparam is designed to be used in the make file updatersiA), The 
parameter bootparams-file should be the bootparams file used in YP data 
base makefile, /usr/etc/yplMakefile . Usually, it is letclbootparams. The 
update request tells updbootparam whether to add or delete an bootparams 
entry. 

FILES 

/usr/etc/yp/updaters 

SEE ALSO 

bootparams(4), updaters(4), ypupdated(lM) 



April 1990 -1- Version 3.0 



YP_BOOTPARAM( IM ) Silicon Graphics YP_BOOTPARAM( IM ) 

NAME 

yp_bootparam - update yp bootp^rams data base 

SYNOPSIS 

yp_bootparam -h host -a [ -b ] [ -k keyjile ] -f file 
yp_bootparam -h host -a [ -b ] [ -k keyjile ] params 
yp_bootparam -h host -d [ ~b ] [ -k keyjile ] 

DESCRIPTION 

ypjbootparam is the user interface tool to update yp bootparams(4) data 
base directly on client workstation without running on ypmaster. 
ypjbootparam uses the ypupdated{\M) service on ypmaster to update the 
bootparams data base. 

User can either add an entry to data base, or delete an entry. As long as the 
hostname is registered in the yp hosts data base and the bootparam entry 
does not exist, user can always add an entry to the bootparams data base. In 
this process, a security key can be requested on return. When deleting an 
entry, the same key (if there is one) must be submitted in the same com- 
mand line. Otherwise, the request will be rejected. The update daemon on 
ypmaster stores the keys in /usr/etc/boot/keystore, while ypjbootparam 
saves the key in the file specified by the input parameter. 

OPTIONS 

-h host Use host as the key in bootparams data base. The host 

will be checked against yp hosts data base unless -b is 
specified. If host is an alias, the real key found in hosts 
data base will be used instead. 

-a To add an entry 

-d To remove an entry. 

-b use host as key without checking yp hosts data base. 

-k keyjile When adding an entry, the keyjile is used to save the 

returned key. When deleting an entry, it is used to pass 
the original key. 

-ffile Tho. file will contain the data part in the bootparam entry. 

It should have the following format: 



April 1990 -1- Version 3.0 



( 



( 



c 



YP_BOOTPARAM( IM ) SiHcon Graphics YP_BOOTPARAM( IM ) 

root=root_server : root_path 
share=share_server: share_path 
swap=root_server: swap_path 
dump=root_server : dump_path 

The dump value is optional. 

params If -/ is not used, the boot parameters should be passed at 

command level. 

EXAMPLE 

yp_bootparam -a -h bonnie -k /mykey 

root=clyde:/bonnieshare=clyde:/share 
swap=clyde:/swap/bonnie 

will create a bootparam entry in ypmaster. The security key returned will 
be left in /mykey. 

FILES 

/usr/etc/yp/yp_bootparam 

/usr/etc/boot/keystore 

/usr/include/rpcsvc/ypclnt.h Error code Usting 

SEE ALSO 

bootparams(4), updbootparam(lM), ypupdated(lM) 
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NAME 

yp_host - update yp hosts data base 

SYNOPSIS 

yp_host -r -h host [ -n net [ -m mask ] ] [ -a aliases ] 
yp_host -c -h host -w newname [ -a aliases ] 
yp_host -d -h host 

DESCRIPTION 

yp_host is the user command to update yp hosts data base directly on client 
workstation without running on ypmaster. ypjiost uses the ypupdated(lM) 
service on ypmaster to update the hosts data base. 

Users can add an entry to data base, change existing data base or delete an 
entry. As long as the host name is not used in the current data base, there 
are no restrictions for creating an entry. However, to modify or delete an 
entry, users will be prompted for the root password of ypmaster. 

ypJiost is provided to avoid using editor on /etc/hosts directly when modi- 
fying the hosts file. The single threaded nature of ypupdated(lM) guaran- 
tees the data base is consistent under multiple updating. In network with 
Silicon Graphics diskless workstations, this feature is especially important 
because the automatic registration request will be received by ypmaster at 
random time due to installation of a new diskless workstation. 

OPTIONS 

-r To register the host name in yp hosts data base. 

-h host Use host as the key in updating hosts data base. 

-n net To specify the network that host will be in. This parame- 

ter should follow the "." notation of Internet address. If 
-m is used, the net should be a four bytes Intemet 
address. If -m is not used, the net should be an Intemet 
network number. 

-m mask To specify the network mask that will be used. This mask 

should have the form of Oxffffffjf, where T' must be a 
valid hexadecimal character. This parameter "and"ed 
with net represents the target Intemet subnet number. 



( 



April 1990 - 1 - Version 3.0 



YP_HOST(lM) 



Silicon Graphics 



YP_HOST(lM) 



-a aliases To specify the aliases of the new host. Multiple aliases 

should be quoted (") in command line. 

-c To change the existing entry. 

-w newname To modify the entry to use newname as the new key for 
hosts data base. 



-d 



To delete an entry. 



EXAMPLE 

yp_host -a -h bonnie -n 192,26.88 -a "bonnie.l bonnie.2" will create 
an entry in ypmaster. The network that new IP address will be using is 
"192.26.88". 



yp^host -a -h bonnie -n 192.26.88.200 -m OxffmTcO -a "bonnie.l bon- 
iiie.2". The subnet that new IP address will be in is "192.26.88.192". 



FILES 

/etc/hosts 

/usr/etc/yp/yp_host 

/usr/include/rpcsvc/ypclnt.h 

SEE ALSO 

registrar(lM), ypupdated(lM) 



Error code listing 
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NAME 



ypinit - build and install Yellow Pages database 



SYNOPSIS 

/usr/etc/yp/ypinit -m 
/usr/etc/yp/ypinit -~s master_name 

DESCRIPnON 

ypinit sets up a Yellow Pages database on a YP server. It can be used to set 
up a master or a slave server. You must be the superuser to run it It asks a 
few, self-explanatory questions, and reports success or failure to the termi- 
nal. 

It sets up a master server using the simple model in which that server is 
master to all maps in the data base. This is the way to bootstrap the YP sys- 
tem; later if you want you can change the association of maps to masters. 
All databases are built from scratch, either from information available to the 
program at runtime, or from the ASCII data base files in fete. These files 
are listed below under FILES • All such files should be in their "traditional" 
form, rather than the abbreviated form used on client machines. 

A YP database on a slave server is set up by copying an existing database 
from a running server. The master jiame argument should be the hostname 
of YP server (either the master server for all the maps, or a server on which 
the data base is up-to-date and stable). 

Refer to ypfiles{4) and ypserv{lm) for an overview of the Yellow Pages. 



OPTIONS 

-m 

-s 

FILES 



Indicates that the local host is to be the YP master. 
Set up a slave database. 



/etc/passwd 

/etc/group 

/etc/hosts 

/etc/networks 

/etc/services 

/etc/protocols 

/etc/netgroup 

/etc/ethers 

SEE ALSO 

makedbm(lM), ypfiles(4), yppush(lM), ypxfr(lM), ypmake(lM), 
ypserv(lM) 



( 
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NAME 

ypmake - rebuild Yellow Pages database 





SYNOPSIS 

cd /usr/etc/yp; ypmake [ map ] 

DESCRIPnON 

On YP master machines, the file called Makefile in /usr/etc/yp is used by 
ypmake to build the Yellow Pages databases. With no arguments, ypmake 
creates dbm(3B) databases for any YP maps that are out-of-date, and then 
executes yppush{lM) to notify slave servers that there has been a change. 

If invoked with map, ypmake will update that map only. Typing ypmake 
passwd will create and yppush the password database (assuming it is out of 
date). Likewise, ypmake hosts and ypmake networks will create databases 
from the host and network files, /etc/hosts and /etc/networks and yppush the 
databases to the slave servers. 

cron{\M) executes ypmake at regular intervals in order to maintain con- 
sistency between YP servers' databases. Once a day, ypmake rebuilds and 
transfers copies of all of the YP databases to the slave servers, and moves 
the log file /usr/etc/yp/ypmake.log to /usr/etc/yp/ypmake.log.old to keep it 
from growing too large. 

ypmake reads the file /etc/ config/ypmaster. options so that users may 
configure the following variables: 

ALIASES 

full pathname of the aliases file used to build the aliases database. 
(Default location is /usr/lib/aliases.) 

DIR the directory of the source files. (Default is /etc.) 

DOM used to construct a domain other than the master's default domain; 

NOPUSH 

when non-null, inhibits doing a yppush of the new database files. 
(Default is the null string.) 

PWFILE 

full pathname of the password file used to build the passwd data- 
base. (Default location is /etc/passwd.) 

YPDIR directory containing YP programs (e.g., makedbm, yppush, etc.). 
(Default is /usr/etc/yp.) 

For instance, to change the location of the password file used by ypmake to 
/etc/passwd.yp, include: 



April 1990 -1- Version 3.0 



YPMAKE( IM ) Silicon Graphics YPMAKE( IM ) 

PWFILE=/etc/passwd.yp 

in /etc/config/ypmaster. options . 

Refer to ypfiles(4) and ypserv(lM) for an overview of the Yellow Pages. 

FILES 

/usr/etc/yp/ypmake.log 

SEE ALSO 

cron(lM), make(l), makedbm(lM), ypserv(lM) 



( 
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NAME 

yppoU - what version of a YP map is at a YP server host 

SYNOPSIS 

/usr/etc/yp/yppoll [ -h host ] [ -d domain ] mapname 

DESCRIPTION 

YppoU asks a ypserv process what the order number is, and which host is 
the master YP server for the named map. If the server is a v.l YP protocol 
server, yppoll uses the older protocol to communciate with it. In this case, 
it also uses the older diagnostic messages in case of failure. 

OPTIONS 

-h host Ask the ypserv process at host about the map parameters. 

If host isn't specified, the YP server for the local host is 
used. That is, the default host is the one returned by 
ypwhich(lM), 

-d domain Use domain instead of the default domain. 

SEE ALSO 

ypserv(lM), ypfiles(4) 
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NAME 

yppush - force propagation of a changed YP map 

SYNOPSIS 

/usr/etc/yp/yppush [ -d domain ] [ -v ] mapname 

DESCRIPTION 

Yppush copies a new version of a Yellow Pages (YP) map from the master | 

YP server to the slave YP servers. It is normally run only on the master YP ^ 

server by the Makefile in lusrletclyp after the master databases are changed. 
It first constructs a list of YP server hosts by reading the YP map ypservers 
within the domain. Keys within the map ypservers are the ASCII names of 
the machines on which the YP servers run. 

A * 'transfer map" request is sent to the YP server at each host, along with 
the information needed by the transfer agent (the program which actually 
moves the map) to call back the yppush . When the attempt has completed 
(successfully or not), and the transfer agent has sent yppush a status mes- 
sage, the results may be printed to stdout. Messages are also printed when a 
transfer is not possible; for instance when the request message is undeliver- 
able, or when the timeout period on responses has expired. 

Refer to ypfiles(4) and ypserv(lM) for an overview of the Yellow Pages. 

OPTIONS 

-d Specify a domain . 

-v Verbose. This causes messages to be printed when each server is 

called, and for each response. If this flag is omitted, only error 
messages are printed. 

FILES 

/usT/otc/yp/domainname/ypservers. {dir, pag} 

SEE ALSO 

ypserv(lM) ypxfr(lM), ypfiles(4) 

BUGS 

In the current implementation (version 2 YP protocol), the transfer agent is 
ypxfir , which is started by the ypserv program. If yppush detects that it is 
speaking to a version 1 YP protocol server, it uses the older protocol, send- 
ing a version 1 YPPROC_GET request and issues a message to that effect. 
Unfortunately, there is no way of knowing if or when the map transfer is 
performed for version 1 servers, yppush prints a message saying that an 
"old-style" message has been sent. The system administrator should later 
check to see that the transfer has actually taken place. 



( 



April 1990 - 1 - Version 3.0 



YPSERV( IM ) SiHcon Graphics YPSERV( IM ) 

NAME 

ypserv, ypbind - Yellow Pages server and binder processes 

SYNOPSIS 

/usr/etc/ypserv [ ~iv ] [ -L logflags ] 
/usr/etc/ypbind 

DESCRIPnON 

The Yellow Pages (YP) provides a simple network lookup service consist- 
ing of databases and processes. The databases are files in a directory tree 
rooted at lusrletclyp. These files are described in ypfiles(4). The processes 
are /usr/etc/ypserv, the YP database lookup server, and /usr/etc/ypbind, 
the YP binder. The programmatic interface to YP is described in 
ypclnt{3N), Administrative tools are described in yppush(lM) ypxfr(lM) 
yppoU(lM) ypwhich(l), and ypset(lM), Tools to see the contents of YP 
maps are described in ypcat(l), and ypmatch{\). Database generation and 
maintenance tools are described in ypinit{\M), ypmake{\M), and 
makedbm(lM), 

Both ypbind and ypserv are daemon processes typically activated at system 
startup time from letclinit.dlnetwork if the configuration flags *'yp" and 
'*ypserv" are set on (see network{lM)). The yp configuration state must be 
on for ypserv to be on. 

ypserv runs only on YP server machines with a complete YP database. 
ypbind runs on all machines using YP services, both YP servers and 
clients. 

The ypserv daemon's primary function is to look up information in its local 
database of YP maps. The operations performed by ypserv are defined for 
the implementor by the YP protocol specification, and for the programmer 
by the header file <rpcsvc/yp_prot.h>. Communication to and from ypserv 
is by means of RPC calls. Lookup functions are described in ypclnt(3N), 
and are supplied as C-callable funtions in lusrllibllibsun.a. There are four 
lookup functions, all of which are performed on a specified map within 
some YP domain: Match, Getjirst, Getjiext, and GetjilL The Match 
operation takes a key, and returns the associated value. The Getjirst 
operation returns the first key- value pair from the map, and Get next can be 
used to enumerate the remainder. Get_all ships the entire map to the reques- 
ter as the response to a single RPC request. 

Two other functions supply information about the map, rather than map 
entries: Get_order_number , and Getjnasterjiame, In fact, both order 
number and master name exist in the map as key- value pairs, but the server 
will not return either through the normal lookup functions. (If you examine 
the map with makedbm(lM), however, they will be visible.) Other func- 
tions are used within the YP subsystem itself, and are not of general interest 
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to YP clients. They include Do_you_servejhis_domain?, Transferjnap, 
and Reinitialize Jnternal_state, 

The function of ypbind is to remember information that lets client 
processes on a single node communicate with some ypserv process. 

ypbind must run on every machine which has YP client processes; ypserv 
may or may not be running on the same node, but must be running some- 
where on the network. 

The information ypbind remembers is called a binding — the association of 
a domain name with the internet address of the YP server, and the port on 
that host at which the ypserv process is listening for service requests. The 
process of binding is driven by client requests. As a request for an unbound 
domain comes in, the ypbind process broadcasts on the net trying to find a 
ypserv process that serves maps within that domain. Since the binding is 
established by broadcasting, there must be at least one ypserv process on 
every net. Once a domain is bound by a particular ypbind, that same bind- 
ing is given to every client process on the node. The ypbind process on the 
local node or a remote node may be queried for the binding of a particular 
domain by using the ypwhich{\) command. 

Bindings are verified before they are given out to a client process. If 
ypbind is unable to speak to the ypserv process it's bound to, it marks the 
domain as unbound, tells the client process that the domain is unbound, and 
tries to bind the domain once again. Requests received for an unbound 
domain will fail immediately. In general, a bound domain is marked as 
unbound when the node running ypserv crashes or gets overloaded. In such 
a case, ypbind will to bind any YP server (typically one that is less-heavily 
loaded) available on the net. 

ypbind also accepts requests to set its binding for a particular domain. The 
request is usually generated by the YP subsystem itself. ypset{\M) is a 
command to access the Setjdomain facility. It is for unsnarling messes, not 
for casual use. 

YPSERV OPTIONS 

-fforklimit 

limits the number of processes ypserv can fork at any given time. 
(The default is 20.) 

-i allows ypserv to resolve non-local host name and address lookups 

with the 4.3BSD Internet domain name server, named{lM). 

-L logflags 

specifies the type(s) of information to be logged in 
lusrletclyplypserv.log (see below), in addition to error messages. 
logflags is a comma-separated list of one or more of: dispatch, 
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inter domain and query cache. 

-V *'Verbose" - display messages to stderr instead of the logfile. 

FILES 

If the file lusrletclyplypserv.log exists when ypserv starts up, log informa- 
tion will be written to this file. 

SEE ALSO 

named(lM), network(lM), ypcat(l), ypmatch(l), yppush(lM), ypwhich(l), 
ypxfr(lM), ypset(lM), ypclnt(3N), ypfiles(4), YP protocol specification 
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NAME 

ypset - point ypbind at a particular server 

SYNOPSIS 

/usr/etc/yp/ypset [-V1I-V2 ] [ -h host ] [ -d domain ] server 

DESCRIPTION 

Ypset tells ypbind to get YP services for the specified domain from the 
ypserv process running on server. If server is down, or isn't running 
ypserv, this is not discovered until a YP cUent process tries to get a binding 
for the domain. At this point, the binding set by ypset will be tested by 
ypbind. If the binding is invalid, ypbind will attempt to rebind for the same 
domain. 

Ypset is useful for binding a client node which is not on a broadcast net, or 
is on a broadcast net which isn't running a YP server host. It also is useful 
for debugging YP client applications, for instance where a YP map only 
exists at a single YP server host. 

In cases where several hosts on the local net are supplying YP services, it is 
possible for ypbind to rebind to another host even while you attempt to find 
out if the ypset operation succeeded. That is, you can type "ypset hostl", 
and then "ypwhich", which replies: "host2", which can be confusing. This 
is a function of the YP subsystem's attempt to load-balance among the 
available YP servers, and occurs when hostl does not respond to ypbind 
because it is not running ypserv (or is overloaded), and hostl, running 
ypserv, gets the binding. 

Server indicates the YP server to bind to, and can be specified as a name or 
an IP address. If specified as a name, ypset will attempt to use YP services 
to resolve the name to an IP address. This will work only if the node has a 
current valid binding for the domain in question. In most cases, server 
should be specified as an IP address. 

Refer to ypfiles(4) and ypserv(lM) for ain overview of the Yellow Pages. 

OPTIONS 

-VI Bind server for the (old) v.l YP protocol. 

-V2 Bind server for the (current) v.2 YP protocol. 

If no version is supplied, ypset, first attempts to set the domain for 
the (current) v.2 protocol. If this attempt fails, ypset, then attempts 
to set the domain for the (old) v.l protocol. 

-hhost Set ypbind's binding on host, instead of locally, host can be 
specified as a name or as an Internet address. 
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-d domain 

Use domain instead of the default domain. 

SEE ALSO 

ypwhich(l), ypserv(lM), ypfiles(4) 
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NAME 

ypupdated - server for changing YP information 

SYNOPSIS 

/usr/etc/rpc.ypupdated 

DESCRIPTION ^ 

ypupdated is a daemon that updates information in the Yellow Pages, nor- | 
mally started up by inetdiyM), ypupdated consults the file updaters(4) in ^ 

the directory lusrletclyp to determine which YP maps should be updated 
and how to change them. 

By default, the daemon requires the most secure method of authentication 
available to it, which currently is AUTH_UNIX. The DES authentication 
method is not implemented at the time. 

FILES 

/usr/etc/yp/updaters 

SEE ALSO 

inetd{\M), updaters(4) 

BUGS 

Access control is insecure. Use only on a trusted network. 



( 
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NAME 

ypxfr - transfer a YP map from some YP server to here 

SYNOPSIS 

/usr/etc/yp/ypxfr [ -f ] [ -h host ] [ -d domain ] 
[ -c ] [ -C tid prog ipadd port ] mapname 

DESCRIPTION 

Yp^r moves a YP map to the local host by making use of normal YP ser- 
vices. It creates a temporary map in the directory /usr/tic/yp/domain 
(which must already exist), fills it by enumerating the map's entries, fetches 
the map parameters (master and order number) and loads them. It then 
deletes any old versions of the map and moves the temporary map to the 
real mapname. 

If ypjfr is run interactively, it writes its output to the terminal. However, if 
it's invoked without a controlling terminal, and if the log file 
lusrletclyplypyfr.log exists, it will append all its output to that file. Since 
ypxfr is run from /usr/spool/cron/crontabslroot, or by ypserv, you can use 
the log file to retain a record of what was attempted, and what the results 
were. 

For consistency between servers, ypj^r should be run periodically for every 
map in the YP data base. Different maps change at different rates: the 
services. by name map may not change for months at a time, for instance, 
and may therefore be checked only once a day in the wee hours. You may 
know that mail.aliases or hosts.byname changes several times per day. In 
such a case, you may want to check hourly for updates. A crontab entry 
can be used to perform periodic updates automatically (see cron{\M). 
Rather than having a separate crontab entry for each map, you can group 
comands to update several maps in a shell script. Examples are in 
lusrletclyp: ypxfr_lpd.sh, (transfer once per day) yp)(fr_2pd.sh, (transfer 
twice per day) and ypjfr_lphr.sh (transfer once per hour). They can serve 
as reasonable first cuts. 

Refer to ypfiles(4) and ypserv(lM) for an overview of the Yellow Pages. 

OPTIONS 

-f Force the transfer to occur even if the version at the master is 

not more recent than the local version. 

-c Don't send a "Clear current map" request to the local ypserv 

process. Use this flag if ypserv is not running locally at the 
time you are running yp:}fr. Otherwise, ypxfr will complain 
that it can't talk to the local ypserv, and the transfer will fail. 
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-h host Get the map from host, regardless of what the map says the 

master is. If host is not specified, ypj^r will ask the 

YP service for the name of the master, and try to get the map 
from there, host may be a name or an Internet address in the 
form a.b.c.d (see inet(3N)), 

-d domain Specify a domain other than the default domain. | 

~C tidprog ipaddport 

This option is only for use by ypserv. When ypserv invokes 
jpji/r , it specifies that ypxfr should call back a yppush process 
at the host with Internet address ipaddr, registered as pro- 
gram number prog, listening on port port, and waiting for a 
response to transaction tid, 

FILES 

/usr/etc/yp/ypxfr.log 

/usr/etc/yp/ypxfr_lpd.sh 

/usr/etc/yp/ypxfr_2pd.sh 

/usr/etc/yp/ypxfr_lph.sh 

/usr/spool/cron/crontabs/root 

SEE ALSO 

ypserv(lM), yppush(lM), ypfiles(4) 



( 



( 
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NAME 

nfssvc, async_daemon - NFS daemons 

SYNOPSIS 

nfssvc(sock) 
int sock; 

async_daemonO 

DESCRIPTION 

Nfssvc starts an NFS daemon listening on socket sock. The socket must be 
AF_INET, and SOCK__DGRAM (protocol UDP/IP). The system caU will 
return only if the process is killed. 

Asyncjiaemon implements the NFS daemon that handles asynchronous I/O 
for an NFS client The system call never returns. 

BUGS 

These two system calls allow kernel processes to have user context. 

SEE ALSO 

mountd(lM) 
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NAME 

ether_ntoa, ether_aton, ether_ntohost, ether_hostton, etherjine - ethemet 
address mapping operations 

SYNOPSIS 

#include <sys/types.h> 
#include <sys/socket.h> 
#indude <net/if.h> 
#include <netinet/in,h> 
#include <netinet/if_ether.h> 

char * 
ether_ntoa(e) 

struct ether_addr *e; 

struct ether__addr * 
ether_aton(s) 

char *s; 

ether_ntohost(hostname, e) 
char *hostname; 
struct ether_addr *e; 

ether_hostton(hostname, e) 
char *hostname; 
struct ether_addr *e; 

ether Jine(l, e, hostname) 
char *1; 

struct ether_addr *e; 
char *hostname; 

DESCRIPTION 

These routines are useful for mapping 48 bit ethemet numbers to their 
ASCII representations or their corresponding host names, and vice versa. 

The function ether jitoa converts a 48 bit ethemet number pointed to by e 
to its standard ACSII representation; it retums a pointer to the ASCII string. 
The representation is of the form: *'x:x:x:x:x:x" where x is a hexadecimal 
number between and ff. The function ether_aton converts an ASCII 
string in the standard representation back to a 48 bit ethemet number; the 
function retums NULL if the string cannot be scanned successfully. 

The function ether jitohost maps an ethemet number (pointed to by e) to its 
associated hostname. The string pointed to by hostname must be long 
enough to hold the hostname and a null character. The function retums 
zero upon success and non-zero upon failure. Inversely, the function 
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ether Jiostton maps a hostname string to its corresponding ethemet number; 
the function modifies the ethemet number pointed to by ^. The function 
also returns zero upon success and non-zero upon failure. 

The function ether Jine scans a line (pointed to by /) and sets the hostname 
and the ethemet number (pointed to by e). The string pointed to by host- 
name must be long enough to hold the hostname and a null character. The 
function retums zero upon success and non-zero upon failure. 

SEE ALSO 

ethers(4) 
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NAME 

exponent, getexportent, setexportent, addexportent, remexportent, endex- 
porlent, getexportopt - get exported file system information 

SYNOPSIS 

#incliide <stdio.h> 

#mdude <exporteiit.h> 

FILE *setexport€iit() 

struct exportent *getexportent(filep) 

FILE*fflepi 
int addexportent(filep, dirname, options) 

FILE *fflep; 

char '^dirname; 

char '^'options; 
int remexportent(filep, dirname) 

FILE *filep; 

char '^'du'name; 
char '"getexportoptCxent, opt) 

struct exportent *xent; 

char *opt; 
void endexportent(filep) 

FILE *mep; 

DESCRIPTION 

These routines access the exported filesystem information in letclxtab . 

setexportent opens the export information file and returns a file pointer to 
use with getexportent, addexportent, remexportent, and endexportent . 
getexportent reads the next line from filep and returns a pointer to an object 
with the following structure containing the broken-out fields of a line in the 
file, letclxtab. The fields have meanings described in exports{A), 



( 



( 



#define ACCESS_OPT ^ ^access" 
#define ROOT_OPT ^ ^root' ' 
#define RO_OPT ^ ^ro" 
#define RW_OPT ^ ^rw" 
#define ANON_OPT ^ ^anon" 
#define NOHIDE_OPT ^ ^nohide" 
struct exportent { 

char *xent_dirname; 

char *xent_options; 



/* machines that can mount fs */ 

/* machines with root access of fs */ 

/* export read-only */ 

/* export read-mostly */ 

/* uid for anonymous requests */ 

/* visible from upper-exported fs */ 

/* directory (or file) to export */ 

/* options, as above */ 



( 
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addexportent adds the exponent to the end of the open file^/c/?. It returns 
if successful and -1 on failure, remexportent removes the indicated entry 
from the list. It also returns on success and -1 on failure, getexportopt 
scans the xentyptions field of the exponent structure for a substring that 
matches opt. It returns the string value of opt, or NULL if the option is not 
found. 

endexponent closes the file. 

NOTE 

The NOHIDE^OPT option is specific to IRIX. 

To compile and link a program that calls these routines, follow the pro- 
cedures for section (3Y) routines as described in intro{3). 



FILES 



/etc/exports 
/etc/xtab 



SEE ALSO 

exportfs(lM), exports(4). 

DL\GNOSTICS 

NULL pointer (0) returned on EOF or error. 

BUGS 

The returned exponent structure points to static information that is 
ovenvritten in each call. 
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NAME 

setmntent, getmntent, addmntent, endmntent, hasmntopt - get file system 
descriptor file entry 

SYNOPSIS 

#include <stdio.h> 

#indude <mntent.h> ^ 

FILE *setmntent(filep, type) V 

char *filep; 
char *type; 

struct mntent *getmntent(filep) 
FILE *filep; 

int addmiiteiit(filep, mnt) 
FILE *filep; 
struct mntent *mnt; 

char 'i'hasmntoptCmnt, opt) 
struct mntent '''mnt; 
char *opt; 

int endmntent(filep) 
FILE *mep; 

DESCRIPTION /^ 

These routines replace the getfsent routines for accessing the file system V 
description file letclfstab. They are also used to access the mounted file 
system description fiXtletclmtab, 

Setmntent opens a file system description file and returns a file pointer 
which can then be used with getmntent, addmntent, or endmntent. The type 
argument is the same as infopen(3S), Getmntent reads the next line from 
filep and returns a pointer to an object with the following structure contain- 
ing the broken-out fields of a line in the filesystem description file, 
<mntent.h>. The fields have meanings described in fstab{4). 

/* file system name */ 
/* file system path prefix */ 

/* dbg, efs, nfs */ 

/* ro, hide, etc. */ 
/* dump frequency, in days */ 
/* pass number on parallel fsck */ 



struct mntent 


( 


char 


*mnt_fsname; 


char 


*mnt_dir; , 


char 


*mntjype; 


char 


*mnt_opts; 


int 


mnt_freq; 


int 


mnt_passno; 



); 



C 
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Addmntent adds the mntent structure mnt to the end of the open ^\& filep. 
Note that filep has to be opened for writing if this is to work. Hasmntopt 
scans the mntypts field of the mntent structure mnt for a substring that 
matches opt. It returns the address of the substring if a match is found, 
otherwise. Endmntent closes the file. 

NOTE 

To compile and link a program that calls these routines, follow the pro- 
cedures for section (3Y) routines as described in intro(3). 

FILES 

/etc/fstab 
/etc/mtab 

SEE ALSO 

fstab(4) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

BUGS 

The returned mntent structure points to static information that is overwritten 
in each call. 
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NAME 

getnetgrent, setnetgrent, endnetgrent, innetgr - get network group entry 

SYNOPSIS 

innetgr(netgroup, machine, user, domain) 
char *netgroup, *machine, *user, *domain; 

setnetgrent(netgroup) 
char *netgroup 

endnetgrentO 

getnetgrent(machinep, userp, domainp) 
char **machinep, **userp, **domainp; 

DESCRIPTION 

Innetgr returns 1 or 0, depending on whether netgroup contains the 
machine, user, or domain triple as a member. Any of the three strings 
machine, user, or domain can be NULL, in which case it signifies a wild 
card. 

Getnetgrent xtix3xn% the next member of a network group. After the call, 
machinep will contain a pointer to a string containing the name of the 
machine part of the network group member, and similarly for userp and 
domainp. If any of machinep, userp or domainp is retumed as a NULL 
pointer, it signifies a wild card. Getnetgrent will maUoc(3) space for the 
name. This space is released when a endnetgrent call is made. Getnetgrent 
returns 1 if it succeeding in obtaining another member of the network 
group, if it has reached the end of the group. 

Setnetgrent establishes the network group from which getnetgrent will 
obtain members, and also restarts calls to getnetgrent from the beginning of 
the fist. If the previous setnetgrent call was to a different network group 
and there has been no intervening call to endnetgrent, an endnetgrent call is 
impHed. Endnetgrent frees the space allocated during the getnetgrent calls. 



FILES 



/usr/etc/netgroup 



( 
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NAME 

mount - keep track of remotely mounted filesystems 

SYNOPSIS 

#include <rpcsvc/mouiith> 

RPC INFORMATION 

Program number: 

MOUNTPROG 

XDR routines: 

xdr_exportbody (xdrs, ex) 

XDR *xdrs; 

struct exports *ex; 
xdr_exports (xdrs, ex) ; 

XDR *xdrs; 

struct exports **ex; 
xdr_nexportbody (xdrs, nex) 

XDR *xdrs; 

struct nexports *nex; 
xdr_nexports (xdrs, nex) ; 

XDR *xdrs; 

struct nexports '^^nex; 
xdr_f handle (xdrs, fh) ; 

XDR *xdrs; 

fhandle_t *fp; 
xdr_fhstatus (xdrs, fhs) ; 

XDR *xdrs; 

struct fhstatus *fhs; 
xdr_groups (xdrs, gr) ; 

XDR *xdrs; 

struct groups *gr; 
xdr_mountbody (xdrs, ml) 

XDR *xdrs; 

struct mountlist *ml; 
xdr_mountlist (xdrs, ml); 

XDR *xdrs; 

struct mountlist **ml; 
xdr_path (xdrs, path) ; 

XDR *xdrs; 

char **path; 
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Procedures: 

MOUNTPROC_MNT 

Argument of xdr_path, returns fhstatus. 

Requires unix authentication. 
MOUNTPROC_DUMP 

No arguments, returns struct mountlist. 
MOUNTPROC_UMNT 

Argument of xdr_path, no results. 

Requires unix authentication. 
MOUNTPROC_UMNTALL 

No arguments, no results. 

Requires unix authentication. 

Unmounts all remote mounts of sender. 
MOUNTPROC_EXPORT 
MOUNTPROC_EXPORTALL 

No arguments, returns struct exports if program version 

is MOUNTPROG_ORIG, struct nexports if program version 

is MOUNTPROG_NEWSGI . 

Versions: 

MOUNTVERS_ORIG 

Universal program version. 
MOUNTVERS_NEWSGI 

SGI enhanced version for complete exports inquiry. 

Structures: 

struct mountlist { /* what is mounted */ 

char *ml_name; 
char *ml_path; 
struct mountlist *ml_nxt; 

}; 

struct fhstatus { 

int fhs_status; 
fhandle_t fhs_fh; 

}; 

* List of exported directories. 

* An export entry with ex_groups NULL indicates an entry 

* which is exported to the world. 

struct exports { 

dev_t ex_dev; /* dev of directory */ 

char *ex_name; /* name of directory */ 

struct groups *ex_groups; /* groups given access */ 
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struct exports *ex_next; 

}; 

struct groups { 

char *g_name; 

struct groups *g_next; 

}; 

* List of exported directories with all options documented 

* in exports (4) . 

struct nexports { 

char *nex_name; 

struct groups *nex_access; 

struct groups *nex_root; 

bool_t nex_ro; 

struct groups *nex_rw; 

int nex_anon; 

bool_t nex_nohide; 
struct nexports*nex_next; 

}; 

SEE ALSO 

exportfs(lM), mount(lM), showmount(lM), mountd(lM), exports(4). 
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NAME 



rnusers, rusers - return information about users on remote machines 



SYNOPSIS 

#include <rpcsvc/ruserSoh> 

rnusers(host) 

char *host 

rusers(host, up) 

char *host 

struct utmpidlearr *up; 

DESCRIPTION 

Rnusers returns the number of users logged on to host (-1 if it cannot deter- 
mine that number). Rusers fills the utmpidlearr structure with data about 
host, and returns if successful. The relevant structures are: 

struct utmparr { /* RUSERS VERS.ORIG */ 

struct utmp **uta_arr; 
intuta cnt 



C 



struct utmpidle ( 

struct utmp ui_utmp; 
unsigned ui_idle; 

); 

struct utmpidlearr { /* RUSERSVERSJDLE */ 

struct utmpidle **uia_arr; 
int uia_cnt 

}; 

RPC INFO 

program number: 

RUSERSPROG 

xdr routines: 

int xdr_utmp(xdrs, up) 

XDR *xdrs; 

struct utmp *up; 
int xdr_utmpidle(xdrs, ui); 

XDR *xdrs; 

struct utmpidle *ui; 
int xdr_utmpptr(xdrs, up); 

XDR *xdrs; 

struct utmp **up; 
int xdr_utmpidleptr(xdrs, up); 



( 
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XDR *xdrs; 

struct utmpidle **up; 
int xdr_utmparr(xdrs, up); 

XDR*xdrs; 

struct utmparr *up; 
int xdr_utmpidlearr(xdrs, up); 

XDR*xdrs; 

struct utmpidlearr *up; 

procs: 

RUSERSPROC_NUM 

No arguments, returns number of users as an unsigned long. 
RUSERSPROC_NAMES 

No arguments, returns wrmparr or 

utmpidlearr, depending on version number. 
RUSERSPROC_ALLNAMES 

No arguments, returns utmparr or 

utmpidlearr, depending on version number. 

Returns listing even for utmp entries satisfying nonuser() in utmp.h. 
versions: 

RUSERSVERS_ORIG 
RUSERSVERS IDLE 
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NAME 

rwall - write to specified remote machines 

SYNOPSIS 

#include <rpcsvc/rwalLh> 

rwall(host, msg); ^ 

char *host, *msg; i 

DESCRIPTION 

Rwall causes host to print the string msg to all its users. It returns if suc- 
cessful. 

RPC INFO 

program number: 

WALLPROG 

procs: 

WALLPROC_WALL 

Takes string as argument (wrapstring), returns no arguments. 
Executes wall on remote host with string, 
versions: 

RSTATVERS GRIG 



SEE ALSO 

rwall(l), shutdown(lm), rwalld(lm) 



( 
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NAME 

yp_update - changes yp information 

SYNOPSIS 

#indude <rpcsvc/ypclnt.h> 

yp_update(domam, map, ypop, key, keylen, data, datalen) 
char '^'domain; 
char *map; 
unsigned ypop 
char *key; 
int keylen; 
char *data; 
int datalen; 

DESCRIPTION 

yp_update() is used to make changes to the YP database. The syntax is the 
same as that of yp_match( ) except for the extra parameter ypop which may 
take on one of four values. If it is YPOP_CHANGE, then the data associ- 
ated with the key will be changed to the new value. If the key is not found 
in the database, then yp_update() will return YPERR_KEY. If ypop has 
the value YPOP_INSERT, then the key-value pair will be inserted into the 
database. The error YPERR_KEY is returned if the key akeady exists in 
the database. To store an item into the database without concern for 
whether it exists already or not, pass ypop as YPOP_STORE and no error 
will be returned if the key aheady or does not exist. To delete an entry, the 
value of ypop should be YPOP^DELETE. 

SEE ALSO 

ypupdated(lM), updaters(lM) 
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NAME 

ypclnt yp_get_(lefault_domain yp_bind yp_unbind yp_match yp_first 
yp_next yp_all yp_order yp_master yperr_string ypprot_err - yellow pages 
client interface 

SYNOPSIS 

#include <rpcsvc/ypclnt.h> /^ 

yp_bind(indomam); ^ 

char *indomam; 

void yp_unbind(indomain) 
char *indomain; 

yp_get_default_domain(outdomain); 
char **outdomain; 

yp_match(indomaiii, inmap, inkey, inkeylen, outval, outvallen) 

char ^indomain; 

char ""inmap; 

char *inkey; 

int inkeylen; 

char **outval; 

int *outvanen| 

yp_first(indomain, inmap, outkey, outkeylen, outval, outvallen) ^ 

char *indomain; ^ 

char *inmap; 

char **outkey; 

int *outkeylen; 

char **outval; 

int *outvallen; 

yp_next(indomain, inmap, inkey, inkeylen, outkey, 

outkeylen, outval, outvallen); 
char *indomain; 
char *inmap; 
char * inkey; 
int inkeylen; 
char **outkey; 
int *outkeylen; 
char **outval; 
int *outvallen; g 

yp_all(indomain, inmap, incallback); V 

char *indomain; 

char *inmap; 

struct ypall_callback incallback; 
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yp_order(indomain, inmap, outorder); 
char *indomam; 
char ''^inmap; 
int *outorder; 

yp_master(indomain, inmap, outname); 
char '^'indomain; 
char i^inmap; 
char **outname; 

char *yperr_strmg(incode) 
int incode; 

ypprot_err(mcode) 
unsigned int incode; 

DESCRIPTION 

This package of functions provides an interface to the Yellow Pages (YP) 
network lookup service. The package can be loaded from the library, 
/usr/lib/libsun.a. Refer to ypfiles(4) and ypserv{lM) for an overview of the 
yellow pages, including the definitions of map and domain , and a descrip- 
tion of the various servers, databases, and commands that comprise the YP. 

All input parameters names begin with in. Output parameters begin with 
out. Output parameters of type char ** should be addresses of uninitialized 
character pointers. Memory is allocated by the YP cHent package using 
maUoc(3), and may be freed if the user code has no continuing need for it. 
For each outkey and outval, two extra bytes of memoi7 are allocated at the 
end that contain NEWLINE and NULL, respectively, but these two bytes 
are not reflected in outkeylen or outvallen . indomain and inmap strings 
must be non-null and null-terminated. String parameters which are accom- 
panied by a count parameter may not be null, but may point to null strings, 
with the count parameter indicating this. Counted strings need not be null- 
terminated. 

All functions in this package of type int retum if they succeed, and a 
failure code (YPERR_xxxc) otherwise. Failure codes are described under 
DIAGNOSTICS below. 

The YP lookup calls require a map name and a domain name, at minimum. 
It is assumed that the client process knows the name of the map of interest. 
Client processes should fetch the node's default domain by calling 
yp_get_default_domain() , and use the returned outdomain as the 
indomain parameter to successive YP calls. 
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To use the YP services, the client process must be ''bound" to a YP server 
that serves the appropriate domain using yp_bind. Binding need not be 
done explicitly by user code; this is done automatically whenever a YP 
lookup function is called, ypjbind can be called directly for processes that 
make use of a backup strategy (e.g., a local file) in cases when YP services 
are not available. 

Each binding allocates (uses up) one client process socket descriptor; each 
bound domain costs one socket descriptor. However, multiple requests to 
the same domain use that same descriptor. ypjinbind() is available at the 
client interface for processes that explicitly manage their socket descriptors 
while accessing multiple domains. The call to yp_unbind() make the 
domain unbound, and free all per-process and per-node resources used to 
bind it. 

If an RPC failure results upon use of a binding, that domain will be 
unbound automatically. At that point, the ypclnt layer will retry forever or 
until the operation succeeds, provided thaiypbind is running, and either 

a) the client process can't bind a server for the proper domain, or 

b) RPC requests to the server fail. 

If an error is not RPC-related, or if ypbind is not running, or if a bound 
ypserv process returns any answer (success or failure), the ypclnt layer will 
return control to the user code, either with an error code, or a success code 
and any results. 

ypjnatch returns the value associated with a passed key. This key must be 
exact; no pattern matching is available. 

yp_fi^s^ returns the first key- value pair from the named map in the named 
domain. 

ypjiextO returns the next key-value pair in a named map. The inkey 
parameter should be the outkey returned from an initial call to ypJirstO (to 
get the second key-value pair) or the one returned from the nth call to 
ypjiextO (to get the nth + second key- value pair). 

The concept of first (and, for that matter, of next) is particular to the struc- 
ture of the YP map being processed; there is no relation in retrieval order to 
either the lexical order within any original (non-YP) data base, or to any 
obvious numerical sorting order on the keys, values, or key- value pairs. 

The only ordering guarantee made is that if the ypJirstQ function is called 
on a particular map, and then the ypjiextO function is repeatedly called on 
the same map at the same server until the call fails with a reason of 
YPERR_NOMORE, every entry in the data base will be seen exactly once. 
Further, if the same sequence of operations is performed on the same map 
at the same server, the entries wiU be seen in the same order. 

April 1990 -3- Version 3.0 



( 



( 



( 



YPCLNT(3Y) Silicon Graphics YPCLNT(3Y) 

Under conditions of heavy server load or server failure, it is possible for the 
domain to become unbound, then bound once again (perhaps to a different 
server) while a client is running. This can cause a break in one of the 
enumeration rules; specific entries may be seen twice by the client, or not at 
all. This approach protects the cHent from error messages that would other- 
wise be returned in the midst of the enumeration. The next paragraph 
describes a better solution to enumerating all entries in a map. 

yp_all provides a way to transfer an entire map from server to client in a 
single request using TCP (rather than UDP as with other functions in this 
package). The entire transaction takes place as a single RFC request and 
response. You can use yp_aU just like any other YP procedure, identify the 
map in the normal manner, and supply the name of a function which will be 
called to process each key-value pair within the map. You return from the 
call to yp_all only when the transaction is completed (successfully or 
unsuccessfully), or your ''foreach" function decides that it doesn't want to 
see any more key- value pairs. 

The third parameter to yp_all is 

struct ypall_callback *incallback { 
int (*foreach)(); 
char *data; 

}; 

The function for each is called 

foreach(instatus, inkey, inkeylen, inval, invallen, indata); 

int instatus; 

char *mkey; 

int inkeylen; 

char *inval; 

int invalllen; 

char *indata; 

The instatus parameter will hold one of the return status values defined in 
<rpcsvc/yp_prot.h> — either YPTRUE or an error code. (See ypprot_err, 
below, for a function which converts a YP protocol error code to a ypclnt 
layer error code.) 

The key and value parameters are somewhat different than defined in the 
synopsis section above. First, the memory pointed to by the inkey and inval 
parameters is private to the yp_all function, and is overwritten with the 
arrival of each new key-value pair. It is the responsibility of the foreach 
function to do something useful with the contents of that memory, but it 
does not own the memory itself. Key and value objects presented to the 
foreach function look exactly as they do in the server's map — if they were 
not newline-terminated or null-terminated in the map, they won't be here 
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FILES 



either. 

The indata parameter is the contents of the incaUback-xiata element 
passed to ypjill . The data element of the callback stmcture may be used to 
share state information between theforeach function and the mainline code. 
Its use is optional, and no part of the YP client package inspects its contents 
— cast it to something useful, or ignore it as you see fit. 

Th&foreach function is a Boolean. It should return zero to indicate that it 
wants to be called again for further received key- value pairs, or non-zero to 
stop the flow of key-value pairs. If foreach returns a non-zero value, it is 
not called again; the functional value of yp_all is then 0. 

y/7_<9rder returns the order number for a map. 

ypjnaster Tctxims the machine name of the master YP server for a map. 

yperrjstring returns a pointer to an error message string that is null- 
terminated but contains no period or newline. 

ypprot_err takes a YP protocol error code as input, and returns a ypclnt 
layer error code, which may be used in turn as an input to yperrjstring . 

/usr/include/rpcsvc/ypclnt.h 
/usr/include/rpcsvc/yp_prot.h 



SEEALSO 

ypfiles(4), ypserv(lM), 

DIAGNOSTICS 

All integer functions return if the requested operation is successful, or one 
of the following errors if the operation fails. 



c 



( 



#define YPERR_BADARGS 


1 


#defineYPERR_RPC 


2 


#define YPERR_DOMAIN 


3 


#define YPERR_MAP 


4 


#define YPERR_KEY 


5 


#define YPERR_YPERR 


6 


#defineYPERR_RESRC 


7 


#define YPERR_NOMORE 


8 


#define YPERR_PMAP 


9 


#define YPERR.YPBIND 


10 


#define YPERR_YPSERV 


11 


#define YPERR_NODOM 


12 



/* args to function are bad */ 

/* RFC failure - domain has been unbound */ 

/* can't bind to server on this domain */ 

/* no such map in seiner's domain */ 

/* no such key in map */ 

/* internal yp server or client error */ 

/* resource allocation failure */ 

/* no more records in map database */ 

/* can't communicate with portmapper */ 

/* can't communicate with ypbind */ 

/* can't comrnunicate with ypserv */ 

/* local domain name not set */ 



( 
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NAME 

yppasswd - update user password in Yellow Pages 

SYNOPSIS 

#include <rpcsYc/yppasswd.h> 

yppasswd(oldpass, newpw) 
char *oldpass 
struct passwd *newpw; 

DESCRIPTION 

If oldpass is indeed the old user password, this routine replaces the pass- 
word entry with newpw. It returns if successful. 

RPC INFO 

program number: 

YPPASSWDPROG 

xdr routines: 

xdr_ppasswd(xdrs, yp) 
XDR *xdrs; 
struct yppasswd *yp; 
xdr_yppasswd(xdrs, pw) 
XDR *xdrs; 
struct passwd *pw; 
procs: 

YPP AS S WDPROC_UPD ATE 

Takes struct yppasswd as argument, returns integer. 
Same behavior as yppasswd() wrapper. 
Uses UNIX authentication, 
versions: 

YPPAS S WD VERS_ORIG 

structures: 

struct yppasswd { 

char * oldpass; /* old (unencrypted) password */ 
struct passwd newpw; /* new pw structure */ 

}; 

SEE ALSO 

yppasswd(l), rpc.passwd(lM) 
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NAME 

bootparams - boot parameter data base 

SYNOPSIS 

/etc/bootparams 

DESCRIPTION 

The bootparams file contains the list of client entries that diskless chents | 
use for booting. For each diskless client the entry should contain the fol- ^ 

lowing information: 

name of cUent 

a list of keys, names of servers, and pathnames. 

The first item of each entry is the name of the diskless client. The subse- 
quent item is a fist of keys, names of servers, and pathnames. 

Items are separated by TAB or SPACE characters. 

EXAMPLE 

Here is an example of the /etc/bootparams file: 

myclient root=myserver:/nfsroot/myclient \ 

swap=myserver:/nfsswap/myclient \ 
dump=myserver:/nfsdump/myclient 

FILES £ 

/etc/bootparams I 

SEE ALSO 

bootparamd(lm) 



( 
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NAME 

ethers - ethemet address to hostname database 

DESCRIPTION 

The ethers file contains information regarding the known (48 bit) ethemet 
addresses of hosts on the internet. For each host on an ethemet, a single 
line should be present with the following information: 

ethemet address 
official host name 

Items are separated by any number of blanks and/or tabs. A *#' indicates 
the beginning of a comment extending to the end of line. 

The standard form for ethemet addresses is **x:x:x:x:x:x" where jc is a hex- 
adecimal number between and ff, representing one byte. The address 
bytes are always in network order. Host names may contain any printable 
character other than a space, tab, newline, or comment character. It is 
intended that host names in the ethers file correspond to the host names in 
the hosts{A) file. 

The ether JineO routine from the ethemet address manipulation library, 
ethers(3Y) may be used to scan lines of the ethers file. 



FILES 



/etc/ethers 



SEE ALSO 

ethers(3Y), hosts(4) 
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NAME 

exports - list of NFS filesystems being exported 

SYNOPSIS 

/etc/exports 

DESCRIPTION ^ 

The file I etcl exports describes the filesystems which are being exported to # 

NFS clients. It is created by the system administrator using a text editor ^ 

and processed by exportfs{\M) at system startup and by the mount request 
daemon, mountd{\M), each time a mount request is received. Exportfs 
should be re-executed after making changes to the file. 

The file consists of a list of filesystems, the netgroupiA) or machine names 
allowed to remote mount each filesystem, and possibly a list of options. 
The filesystem names are left justified and followed by a list of names 
separated by white space. The names will be looked up in letc/netgroup 
and then in /etc/hosts. A hyphen indicates the start of the options fist. Mul- 
tiple options are separated by commas. The default options are 
rw,hide,anon=nobody, 

ro Export the directory read-only. If not specified, the directory is 

exported read- write. 

rv/=hostname[ihostname] ... 

Export the directory read-mostly. Read-mostly means exported 
read-only to most machines, but read- write to those specified. If no 
hosts are specified, the directory is exported read-write to all. 

anon=ufd 

If a request comes from an unknown user, use aid as the effective 
user ID. uid may be either a name or an integer user-id from 
letclpasswd. The default value for this option is **nobody" (uid 
-2). Setting the value of **anon" to -1 disables anonymous 
access. Note: root users (uid 0) are always considered "unknown" 
by the NFS server, unless they are included in the "root" option 
below. 

root=hostname[ihostname] ... 

Give root access only to the root users from a specified hostname. 
The default is for no hosts to be granted root access. 

BCQess=cUent[iclient] . . . 

Give mount access to each client Usted. A client can either be a ^ 

hostname, or a netgroup (see netgroup{4)). Each client in the list I 

is first checked for in the letclnetgroup database, and then the 
/etc/hosts database. The default value allows any machine to 
mount the given directory. 
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hide Prevents a client who mounts this entry's parent filesystem from 
accessing files in this filesystem. Instead, clients who mount a 
filesystem containing a hidden filesystem access the directory on 
which the hidden child is mounted, not the child filesystem 's root 
directory. 

nohide Allows a client who mounts this entry's parent filesystem to access 
files in this filesystem. 

wsync Causes all writes to this file system to be performed synchronously 
to the disk. With this option, the server waits until the data is safely 
written to the disk before sending a positive response to the client. 
Without this option, the server performs delayed-writes (i.e., 
responds to the client then writes the data at its convenience or 
when a sync {2) is executed). Delaying writes provides a great per- 
formance boost, but also introduces the risk of losing data should 
the server crash before the data is written to the disk. Use the 
wsync option if this risk is unacceptable. 

A filesystem name which is not followed by a name list is exported to 
everyone. A **#" anywhere in the file indicates a comment extending to 
the end of the line on which it appears. Lines beginning with white space 
are continuation Unes. 



/usr/local 


/usr 


clients 


/usi2 


bonnie Clyde 


/usr3 


--anon=guest 


/ 


-ro 


/usr 


-ro,nohide 



# export to the world 

# export to my clients 

# export to only these machines 

# map client root & anonymous to guest 

# export the root and usr filesystems 

# export all local filesystems read-only 



NOTE 



FILES 



Exporting all your machine's local filesystems requires enumerating 
all local mount points, and using * 'nohide" for each root filesystem: 



/ 


-ro 


/usr 


-ro,nohide 


/d 


-ro,nohide 



The rootid option is a backward-compatible IRIX synonym for anon. 
The hide, nohide and wsync options are specific to IRIX. 

/etc/exports 
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SEE ALSO 

exportfs(lM), mountd(lM), netgroup(4) 



( 
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NAME 

hosts.equiv - list of trusted hosts 

DESCRIPTION 

The letclhosts.equiv file contains a list of trusted hosts. When an rcp(lC), 
rdist{lC), rloginilC) or rsh{lC) request from such a host is made, and the 
initiator of the request is in letclpasswd, then, no further validity checking is 
done. That is, rlogin does not prompt for a password, and rsh completes 
successfully. So a remote user is *'equivalenced'* to a local user with the 
same user name when the remote user is in hosts.equiv. 

The format of hosts.equiv is a list of names, as in this example: 

host! 
host2 
+@ group 1 
-@group2 

A line consisting of a simple host name means that anyone logging in from 
that host is trusted. A line consisting of +@group means that all hosts in 
that network group (see net group (4)) are trusted. A line consisting of 
-@group means that hosts in that group are not trusted. Programs scan 
hosts.equiv linearly, and stop at the first hit (either positive for hostname 
and +@ entries, or negative for -@ entries). A line consisting of a single + 
means that everyone is trusted. 

The .rhosts file has the same format as hosts.equiv. When user XKX exe- 
cutes rep, rdist, rlogin, or rsh, the .rhosts file from XXX' s home directory 
is conceptually concatenated onto the end of hosts.equiv for permission 
checking. However, -^ entries are not sticky. If a user is excluded by a 
minus entry from hosts.equiv but included in .rhosts, then that user is con- 
sidered trusted. In the special case when the user is root, then only the 
/.rhosts file is checked. 

It is also possible to have two names (separated by white space) on a line of 
these files. In this case, if the remote host is equivalenced by the first name, 
then the user named by the second name is allowed to log in as anyone, that 
is, specify any name to the -1 flag (provided that name is in the letclpasswd 
file, of course). Thus the entry 

gotham batman 

in letclhosts.equiv allows batman to log in from gotham as anyone. The 
usual usage would be to put this entry in the .rhosts file in the home direc- 
tory for robin . 
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Then batman may log in as robin when coming from gotham. The second 
entry may be a netgroup, thus 

+@groupl +@group2 

allows any user in group! coming from a host in groupl to log in as any- 
one. 

FILES 

/etc/hosts.equiv 
7.rhosts 

WARNING 

The references to network groups (+@ and -@ entries) in hosts. equiv and 
.rhosts are only supported when the netgroup file is supplied by the Yellow 
Pages. 

SEE ALSO 

rcp(lC), rdist(lC), rlogin(lC), rsh(lC), ruserok(3N), netgroup{4), rhosts(4) 



( 
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NAME 

netgroup - list of network groups 

DESCRIPTION 

Netgroup defines network wide groups, used for permission checking when 
doing remote mounts, remote logins, and remote shells. For remote mounts, 
the information in netgroup is used to classify machines; for remote logins 
and remote shells, it is used to classify users. Each line of the netgroup file 
defines a group and has the format 

groupname memberl member2 .... 

where member/ is either another group name, or a triple: 

(hostname, usemame, domainname) 

Any of three fields can be empty, in which case it signifies a wild card. 
Thus 

universal („) 

defines a group to which everyone belongs. Field names that begin with 
something other than a letter, digit or underscore (such as *'-") work in pre- 
cisely the opposite fashion. For example, consider the following entries: 

justmachines (analytica,-,sun) 
justpeople (-,babbage,sun) 

The machine analytica belongs to tlie group justmachines in the domain 
sun, but no users belong to it. Similarly, the user babbage belongs to the 
group justpeople in the domain sun, but no machines belong to it. 

Network groups are contained in the yellow pages, and are accessed 
through these files: 

/tic/yp/domainname/noigroup.diT 

/cic/yp/domainname/nQigroup.pag 

/etc/yp/d(9mflm/i(3m^/netgroup.byuser.dir 

/etc/yp/d(9m(3/Ainame/netgroup.byuser.pag 

/etc/yp/<i(9m(3m/iame/netgroup.byhost.dir 

/ttc/yp/domainname/nQigroup.hyhostpag 

These files can be created from /etc/ netgroup using makedbm{lM). 



FILES 



/etc/netgroup 

/tic/yp/domainname/nQigroup.dk 

hic/yp/domainname/nQigroup.pag 

/cic/yp/domainname/nQigroup.hyus&T.diT 

/ctc/yp/domainname/ntigroup.hyusoT.pag 
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/etc/yp/d<9mam/iame/netgroup.byhost.dir 
/etc/yp/d<9/nam/iame/netgroup.byhost.pag 

SEE ALSO 

getnetgren t(3) , makedbm( 1 M) , ypserv( 1 M) 
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NAME 

rmtab - remotely mounted file system table 

DESCRIPTION 

Rmtab resides in the directory letc and contains a record of all clients that 
have done remote mounts of file systems from this machine. Whenever a 
remote mount is done, an entry is made in the rmtab file of the machine 
serving up that file system. Umount removes entries of a remotely mounted 
file system. Umount -a broadcasts to all servers, and informs them that 
they should remove all entries from rmtab created by the sender of the 
broadcast message (this is done automatically during system startup). The 
table is a series of lines of the form: 

hostnameidirectory 

This table is used only to preserve information between crashes, and is read 
only by mountd(lM) when it starts up. Mountd keeps an in-core table, 
which it uses to handle requests from programs Uke showmount(l) and 
shutdown(lM). 

FILES 

/etc/rmtab 

SEE ALSO 

showmount(l), mountd(lM), mount(lM), umount(lM), shutdown(lM) 

BUGS 

Although the rmtab table is close to the truth, it is not always 100% accu- 
rate. 
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NAME 

sm, sm.bak, state - statd directories and file structures 

SYNOPSIS 

/usr/etc/statd,d/sm 

/usr/etc/statd.d/sm.bak 

/usr/etc/state 

DESCRIPTION 

/usr/etc/statd.d/sm and /usr/etc/statd.d/sm.bak are directories generated 
by statd. Each entry in /usr/etc/statd.d/sm represents the name of a 
machine to be monitored by statd. Each entry in /usr/etc/statd.d/sm.bak 
represents the name of a machine to be notified of statd's recovery. 

/usr/etc/statd.d/state is a file generated by statd to record its version 
number. This version number is incremented each time a crash or recovery 
takes place. 

FILES 

/usr/etc/statd.d/sm 

/usr/etc/statd.d/sm.bak 

/usr/etc/statd.d/state 

SEE ALSO 

lockd(lM), statd(lM) 
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NAME 

updaters - configuration file for YP updating 

SYNOPSIS 

/usr/etc/yp/updaters 

DESCRIPTION 

The file /usr/etc/yp/updaters is a makefile (see make (I)) which is used for 
updating YP databases. Each entry in the file is a make target for a particu- 
lar YP database. For example, if there is a YP database named 
passwd.byname that can be updated, there should be a make target named 
passwd.byname in the updaters file with the command to update the file. 

The information necessary to make the update is passed to the update com- 
mand through standard input. The information passed is described below 
(all items are followed by a NEWLINE, except for 4 and 6) 

• Network name of client wishing to make the update (a string) 

• Kind of update (an integer) 

• Number of bytes in key (an integer) 

• Actual bytes of key 

• Number of bytes in data (an integer) 

• Actual bytes of data 

After getting this information through standard input, the command to 
update the particular database should decide whether the user is allowed to 
make the change. If not, it should exit with the status YPERR_ACCESS. If 
the user is allowed to make the change, the command should make the 
change and exit with a status of zero. If there are any errors that may 
prevent the updater from making the change, it should exit with the status 
that matches a vahd YP error code described in <rpcsvc/ypclnt.h>. 

FILES 

/usr/etc/yp/updaters 

SEE ALSO 

make{\), ypupdated(lM) 

BUGS 

Access control is insecure. Use only on a trusted network. 
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NAME 

ypfiles - the Yellow Pages database and directory structure 

DESCRIPTION 

The yellow pages (YP) network lookup service uses a database of dbm(3B) 
files in the directory hierarchy at lusrletclyp. A dbm database consists of 
two files, created by calls to the dbm library package. One has the filename 
extension ,pag and the other has the filename extension dir. For instance, 
the database named hosts. by name, is implemented by the pair of files 
hosts. byname. pag and hosts.byname.dir, A dbm database served by the YP 
is called a YP map. A YP domain is a named set of YP maps. Each YP 
domain is implemented as a subdirectory of lusrletclyp containing the map. 
Any number of YP domains can exist. Each may contain any number of 
maps. 

No maps are required by the YP lookup service itself, although they may be 
required for the normal operation of other parts of the system. There is no 
list of maps which YP serves - if the map exists in a given domain, and a 
cUent asks about it, the YP will serve it. For a map to be accessible con- 
sistenfly, it must exist on all YP servers that serve the domain. To provide 
data consistency between the replicated maps, entries to run ypj^r periodi- 
cally exist in lusrlspoollcronlcrontabslroot on each server. More informa- 
tion on this topic is in y/?jc/r(lM). . 

YP maps should contain two distinguished key-value pairs. The first is the 
key YP_LAST_MODIFIED, having as a value a ten-character ASCII order 
number. The order number should be the UNIX time in seconds when the 
map was built. The second key is YP_MASTER_NAME, with the name of 
the YP master server as a value. makedbm(lM) generates both key-value 
pairs automatically. A map that does not contain both key-value pairs can 
be served by the YP, but the ypserv process will not be able to return values 
for **Get order number" or **Get master name" requests. In addition, 
values of these two keys are used by ypxfr when it transfers a map from a 
master YP server to a slave, liypj^r cannot figure out where to get the map, 
or if it is unable to determine whether the local copy is more recent than the 
copy at the master, you must set extra command line switches when you run 
it. 

YP maps must be generated and modified only at the master server. They 
are copied to the slaves using ypxfr {\M) to avoid potential byte-ordering 
problems among YP servers running on machines with different architec- 
tures, and to minimize the amount of disk space required for the dbm files. 
The YP database can be initially set up for both masters and slaves by using 
ypinitilM), 
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After the server databases are set up, it is probable that the contents of some 
maps will change. In general, some ASCII source version of the database 
exists on the master, and it is changed with a standard text editor. The 
update is incorporated into the YP map and is propagated from the master 
to the slaves by running lusrletclyplypmake. ypmake executes the file 
lusrletclyplMakefile and logs its activity in lusrletclyplypmake.log, 
lusrletclyplMakefile contains entries for all supplied maps; if you add a YP 
map, edit this file to support the new map. The makefile uses makedbm to 
generate the YP map on the master, and yppush to propagate the changed 
map to the slaves, yppush is a client of the map ypservers , which lists all 
the YP servers. For more information on this topic, see yppush(lM). 

SEE ALSO 

makedbm(lM), ypinit(lM), ypmake(lM), ypxfr(lM), yppush(lM), 
yppoll(lM), ypserv(lM), rpcinfo(lM), dbm(3B) 
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